Billing — nền tảng Gommo (preview)

Sắp có trên nền tảng Gommo

UX billing thống nhất trên site (/vi/billing/*, portal credits) là xem trước những gì Gommo sẽ ship. API payment Gommo đã có upstream; wrapper gateway không phải hợp đồng lâu dài.

→ Roadmap nền tảng Gommo

Tách khỏi /gateway — nạp credit qua Gommo (mặc định) hoặc PayOS legacy + sendBalances.

Env

Biến	Mục đích
GOMMO_API_DOMAIN	Domain gửi lên Gommo
TOPUP_ORDERS_FILE	File JSON lưu đơn local
PAYOS_*	Chỉ cho legacy /vi/billing/topup/create
GOMMO_ACCESS_TOKEN	Fulfill legacy qua sendBalances

Endpoints

Method	Path	Auth	Mode
GET	/vi/billing/status	—	—
GET	/vi/billing/packages	—	—
POST	/vi/billing/payment/create	Bearer user	Gommo
POST	/vi/billing/payment/sync	Bearer user	Gommo
GET	/vi/billing/topup/orders	Bearer user	Lịch sử local
POST	/vi/billing/topup/create	Bearer user	PayOS legacy
GET/POST	/vi/billing/webhook/payos	PayOS signature	Legacy

Tạo payment Gommo

curl.exe -X POST "http://localhost:3001/billing/payment/create" ^
  -H "Authorization: Bearer USER_TOKEN" ^
  -H "Content-Type: application/json" ^
  -d "{\"username\":\"gommo_user\",\"packageId\":\"basic-member\"}"

Body tùy chọn: promoCode, referralCode, invoiceBuyer.

Sync payment

curl.exe -X POST "http://localhost:3001/billing/payment/sync" ^
  -H "Authorization: Bearer USER_TOKEN" ^
  -H "Content-Type: application/json" ^
  -d "{\"orderCode\":\"SP...\"}"

Khi data.paid là true, gateway đánh dấu đơn local credited.

Gói credit

Xem GET /billing/packages hoặc src/services/creditPackages.ts.