BIGO — Recharge

#POST /bigo/recharge

Create a BIGO LIVE diamond recharge order. Same contract as the Likee recharge: Boostigo re-identifies the account, checks the configured price and your key balance, debits the key and returns an order_id.


Method	`POST`
URL	`https://api.boostigo.io/bigo/recharge`
Auth	`Authorization: Bearer YOUR_API_KEY` (a BIGO API key)
Headers	`Accept: application/json`, `Content-Type: application/json`

#Request body

{
  "bigo_id": "yehya_aali",
  "bigo_uid": "502030637",
  "diamond": 1000,
  "amount": "19.00",
  "request_id": "ORDER-CLIENT-20001"
}

Field	Type	Required	Description
`bigo_id`	string	yes	Public BIGO ID entered by the end user
`bigo_uid`	string	yes	UID returned by Identify; a mismatch is rejected with `BIGO_UID_MISMATCH` — nothing is charged
`diamond`	integer	yes	Diamonds to deliver; must be a configured amount for your key (`INVALID_DIAMOND_AMOUNT` otherwise)
`amount`	string	yes	Your configured BIGO selling price for that amount — see Pricing & amount
`request_id`	string	yes	Your unique reference (idempotency key, unique per API key)

#cURL

curl --request POST \
  "https://api.boostigo.io/bigo/recharge" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{"bigo_id":"yehya_aali","bigo_uid":"502030637","diamond":1000,"amount":"19.00","request_id":"ORDER-CLIENT-20001"}'

#Response `201 Created`

{
  "success": true,
  "data": {
    "order_id": "BST-BGO-4K9QM2XT",
    "request_id": "ORDER-CLIENT-20001",
    "platform": "bigo",
    "bigo_id": "yehya_aali",
    "bigo_uid": "502030637",
    "diamond": 1000,
    "amount": "19.00",
    "currency": "USD",
    "status": "pending",
    "created_at": "2026-09-07T14:10:00Z",
    "updated_at": "2026-09-07T14:10:00Z"
  }
}

BIGO orders are accepted with status: pending and move to processing → success / failed as they are fulfilled. Your key is debited at creation and refunded automatically if the order fails. Track completion via the order.success / order.failed webhooks or GET /orders/{order_id} — the order id prefix is BST-BGO-….

#Errors

Same as Likee Recharge, with INVALID_BIGO_ID / BIGO_UID_MISMATCH instead of the Likee codes.

HTTP	code
422	`INVALID_REQUEST_ID`, `INVALID_BIGO_ID`, `BIGO_UID_MISMATCH`, `INVALID_DIAMOND_AMOUNT`, `AMOUNT_MISMATCH`
404	`USER_NOT_FOUND`
402	`INSUFFICIENT_BALANCE`
403	`PLATFORM_NOT_ENABLED` — the key is not a BIGO key / BIGO not active for the store
429 / 503	`RATE_LIMIT_EXCEEDED` / `SERVICE_UNAVAILABLE`