Skip to main content
POST
/
v1
/
create-order
Create Order
curl --request POST \
  --url https://api.example.com/v1/create-order

​
Create Order

Place a top-up order for a customer. Your balance will be deducted immediately.

​
Request

POST /v1/create-order
{
  "api_key": "your-api-key",
  "ref_id": "ORDER-20260328-001",
  "product_sku": "ml-diamonds-86",
  "customer_no": "123456789",
  "customer_no_zone": "1234",
  "sign": "MD5(api_key + api_secret + ref_id)"
}

​
Signature

sign = MD5(api_key + api_secret + ref_id)

​
Request Fields

FieldTypeRequiredDescription
api_keystringYesYour API key
ref_idstringYesYour unique reference ID (max 50 chars)
product_skustringYesProduct SKU from price list
customer_nostringYesCustomer’s game ID / phone number
customer_no_zonestringNoZone/Server ID (required for some games like MLBB)
signstringYesMD5 signature
Each ref_id must be unique. Using a duplicate ref_id will return a DUPLICATE_REF_ID error. We recommend using a format like {PREFIX}-{TIMESTAMP}-{COUNTER}.

​
Response

​
Success (Instant)

200
{
  "success": true,
  "data": {
    "ref_id": "ORDER-20260328-001",
    "product_sku": "ml-diamonds-86",
    "customer_no": "123456789",
    "status": "success",
    "serial_number": "SN-XYZ789ABC",
    "price": 16500,
    "balance_before": 1500000,
    "balance_after": 1483500,
    "message": "Transaction successful"
  },
  "message": "OK"
}

​
Pending (Async processing)

200
{
  "success": true,
  "data": {
    "ref_id": "ORDER-20260328-001",
    "product_sku": "ml-diamonds-86",
    "customer_no": "123456789",
    "status": "pending",
    "serial_number": null,
    "price": 16500,
    "balance_before": 1500000,
    "balance_after": 1483500,
    "message": "Transaction is being processed"
  },
  "message": "OK"
}

​
Response Fields

FieldTypeDescription
ref_idstringYour reference ID
product_skustringProduct SKU
customer_nostringCustomer’s game ID
statusstringpending, success, or failed
serial_numberstringSerial number (null if pending)
pricenumberAmount deducted from your balance
balance_beforenumberBalance before this transaction
balance_afternumberBalance after this transaction
messagestringHuman-readable status message
If the status is pending, set up a webhook or poll the check order endpoint to get the final status.

​
Game ID Reference

Gamecustomer_nocustomer_no_zone
Mobile LegendsUser IDZone ID (required)
Free FirePlayer IDNot needed
Genshin ImpactUIDNot needed
PUBG MobilePlayer IDNot needed
ValorantRiot ID (Name#TAG)Not needed
Honor of KingsPlayer IDNot needed