BIGO Diamond — Fast & Secure Recharge

Fetch Account Info

Verify your API Key and fetch account’s public data (nickname, UID, and avatar). This is the first step in the integration process.

Endpoint: POST https://bigodiamond.com/app/api/uinfo/xa92fd

Headers:

X-API-KEY: YOUR_KEY_HERE
Content-Type: application/x-www-form-urlencoded

Body: bigoid=dino_live

Example Request (cURL)

curl -X POST https://bigodiamond.com/app/api/uinfo/xa92fd \
-H "X-API-KEY: YOUR_API_KEY_HERE" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "bigoid=dino_live"

Example Response

{
  "success": true,
  "image": "https://bigodiamond.com/img/users/dino_avatar.png",
  "nickname": "Dino",
  "uid": "103874",
  "error": null
}

Submit Recharge Request

Send a BIGO Live recharge request directly through the API. This endpoint authenticates your api_key, validates wallet balance, and automatically assigns the order to an available distributor.

Endpoint: POST https://bigodiamond.com/app/api/utopup/xa92fd

Headers:

Api_Key: YOUR_API_KEY_HERE
Content-Type: application/json

Body (JSON):

{
      "bigo_id": "user123ABC",     # Example: BIGO account ID (can contain letters or numbers)
      "bigo_uid": "987654321",     # Example: BIGO UID, usually numeric but may include characters
      "diamond": 1000,             # Example: Number of diamonds to recharge
      "amount": 25.50,             # Example: Amount in your local currency
      "method": "custom"           # Allowed values: "custom", "redeem", or "packages"
    }

Example Request (cURL)

curl -X POST https://bigodiamond.com/app/api/utopup/xa92fd \
    -H "Content-Type: application/json" \
    -H "Api_Key: YOUR_API_KEY_HERE" \
    -d '{
      "bigo_id": "user123ABC",     # Example: BIGO account ID (letters or numbers)
      "bigo_uid": "987654321",     # Example: BIGO UID (can include letters)
      "diamond": 1000,             # Example: number of diamonds
      "amount": 25.50,             # Example: amount in local currency
      "method": "custom"           # Allowed: "custom", "redeem", "packages"
    }'

Example Response

{
      "success": true,
      "message": "Order accepted and assigned to distributor.",
      "order_no": 1045,
      "executed_by": "dgd_distributor_demo",
      "order_price": 25.50,
      "wallet_balance_after": 474.50,
      "status": "processing",
      "status_detail": "status:1"
    }

Check Order Status

Retrieve the current status and full details of a submitted BIGO recharge order. This endpoint is used when you want to track or verify an order programmatically.

Endpoint: POST https://bigodiamond.com/app/api/recharge/status

Headers:

Api_Key: YOUR_API_KEY_HERE
Content-Type: application/json

Body (JSON):

{
      "order_no": 1045
    }

Example Request (cURL)

curl -X POST https://bigodiamond.com/app/api/ostatus/xa92fd \
    -H "Content-Type: application/json" \
    -H "Api_Key: YOUR_API_KEY_HERE" \
    -d '{
      "order_no": 1045
    }'

Example Response

{
      "success": true,
      "order": {
        "order_no": 1045,
        "bigo_id": "user123ABC",
        "bigo_uid": "987654321",
        "requested_diamond": 1000,
        "recharged_diamond": 1000,
        "status": "success",
        "status_detail": "status:2",
        "bigo_order_id": "BIGO123456",
        "executed_by": "dgd_distributor_demo",
        "topup_datetime": "2025-11-06 21:42:57"
      }
    }

Notes:

If status = pending, the recharge is still being processed.
If status = success, the recharge completed successfully.
If status = failed, check status_detail or last_error for more information.

Callback / Webhook Notification

After a recharge request is completed, the system automatically sends a Callback (Webhook) to your server to confirm the final result. This ensures your application stays synchronized with real-time transaction updates.

Endpoint (Your Server): POST https://yourdomain.com/app/api/callback/receiver.php

Description:

Triggered automatically once order status changes to success or failed.
Sent from our system (callback_sender) to your endpoint URL.
Content-Type is always application/json.

JSON Payload:

{
      "order_no": 1045,
      "bigo_id": "user123ABC",
      "bigo_uid": "987654321",
      "diamond": 1000,
      "amount": 25.50,
      "status": "success",
      "status_detail": "status:2",
      "executed_by": "dgd_distributor_demo",
      "completed_at": "2025-11-06T21:42:57Z",
      "signature": "ae3b27fddae2c15b10c9caa790..."
    }

Security:

Each callback includes a signature (HMAC hash) to verify authenticity.
Ensure you validate this before accepting the data.
Callback retries up to 3 times if your server doesn’t respond with HTTP 200.

Example cURL (Webhook sent by system)

curl -X POST https://yourdomain.com/app/api/callback/receiver.php \
    -H "Content-Type: application/json" \
    -d '{
      "order_no": 1045,
      "bigo_id": "user123ABC",
      "bigo_uid": "987654321",
      "diamond": 1000,
      "amount": 25.50,
      "status": "success",
      "status_detail": "status:2",
      "executed_by": "dgd_distributor_demo",
      "completed_at": "2025-11-06T21:42:57Z",
      "signature": "ae3b27fddae2c15b10c9caa790..."
    }'

Example Response (Your Server)

{
      "success": true,
      "message": "Callback received and processed successfully.",
      "logged_to": "app/api/callback/logs/callback_20251106_214257.log"
    }

Log Location: /app/api/callback/logs/
Each callback is stored in a timestamped log file for auditing and debugging.

Redeem Diamonds Using Codes

Redeem BIGO Diamonds using secured Redeem Codes. This API handles both:

Code Validation (Check only)
Code Redemption (Apply to BIGO account)

Endpoint: POST https://bigodiamond.com/app/api/redeem/xa92fd

Headers:

Api_Key: YOUR_API_KEY_HERE
Content-Type: application/json

Mode 1: CHECK Code

{
      "redeem_code": "BD-TEST-2000C"
    }

Mode 2: SUBMIT Code

{
      "redeem_code": "BD-TEST-2000C",
      "bigo_id": "yehya_aali",
      "bigo_uid": "502030637"
    }

Example Request (cURL) — CHECK

curl -X POST https://bigodiamond.com/app/api/redeem/xa92fd \
    -H "Content-Type: application/json" \
    -H "Api_Key: YOUR_API_KEY_HERE" \
    -d '{
      "redeem_code": "BD-TEST-2000C"
    }'

Example Response — CHECK

{
      "success": true,
      "valid": true,
      "code": "BD-TEST-2000C",
      "diamond_value": 2000,
      "status": "available"
    }

Example Request (cURL) — SUBMIT

curl -X POST https://bigodiamond.com/app/api/redeem/xa92fd \
    -H "Content-Type: application/json" \
    -H "Api_Key: YOUR_API_KEY_HERE" \
    -d '{
      "redeem_code": "BD-TEST-2000C",
      "bigo_id": "yehya_aali",
      "bigo_uid": "502030637"
    }'

Example Response — SUBMIT

{
      "success": true,
      "message": "Redeem successful",
      "redeem_code": "BD-TEST-2000C",
      "applied_to": {
        "bigo_id": "yehya_aali",
        "bigo_uid": "502030637"
      },
      "diamond_added": 2000,
      "status": "completed"
    }

Each developer must use a unique API Key generated from their account settings.

You can generate or manage your key inside My Account → API Access.