Place Order
Place order.
Interface Address:
/papi/order/createRequest Method:
POSTContent-Type:
application/jsonHeader Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Access-Key | string | Yes | API access key ID. See API Rules for authentication |
| X-Signature | string | Yes | Signature value, Base64-encoded HMAC-SHA256 result |
| X-Timestamp | string | Yes | Millisecond-level Unix timestamp (13 digits) |
| X-Nonce | string | Yes | Random string, 10~32 lowercase letters + digits |
Body Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| productCode | string | Yes | Product code |
| packageCode | string | Yes | Package code |
| skuCode | string | Yes | SKU code |
| quantity | integer | No | Purchase quantity, default 1 |
| payCode | string | Yes | Payment method |
| providerCode | string | Yes | Provider code |
| modelSid | string | No | Model SID, required when purchasing High-end Real Devices (customizeType=2) |
| payParams | object | No | Payment parameters |
| ├─ key | object | No | key |
Request Example:
{
"productCode": "CLOUD_PHONE",
"packageCode": "s2e9pd6r6x",
"skuCode": "gy5zp58kt3",
"quantity": 1,
"payCode": "wxpayUs",
"providerCode": "Wallyt412",
"modelSid": "string",
"payParams": {
"key": {}
}
}Response Parameters:
| Parameter | Type | Description |
|---|---|---|
| code | integer | Error code. See Error Codes |
| data | object | Response data |
| ├─ orderNo | string | Order number |
| ├─ qrcodeUrl | string | QR code URL |
| ├─ payUrl | string | Payment URL |
| ├─ payParams | object | Payment parameters (specific parameters for various payment methods, such as APP payment parameters) |
| ├─├─ key | object | key |
| ├─ payAmount | integer | Payment amount (cents) |
| ├─ payAmountYuan | number | Payment amount (yuan) |
| ├─ currency | string | Currency unit |
| ├─ expireTime | integer | Order expiration time (timestamp) |
| ├─ payMethod | string | Payment method |
| ├─ payIcon | string | Payment method icon |
| ├─ payType | integer | Payment type |
| ├─ payScene | integer | Payment scene |
| ├─ transactionId | string | Transaction ID |
| ├─ productName | string | Product name |
| ├─ description | string | Order description |
| msg | string | Error message |
Response Example:
{
"code": 0,
"data": {
"orderNo": "",
"qrcodeUrl": "",
"payUrl": "",
"payParams": {
"": {}
},
"payAmount": 0,
"payAmountYuan": 0.0,
"currency": "",
"expireTime": 0,
"payMethod": "",
"payIcon": "",
"payType": 0,
"payScene": 0,
"transactionId": "",
"productName": "",
"description": ""
},
"msg": ""
}Wallet payment rules
Wallet payment uses payCode=WALLET and providerCode=INTERNAL. Mixed payment uses the actual online channel plus an integer walletPayAmount in USD cents, greater than zero and below the calculated payable total; do not submit onlinePayAmount. Recharge orders cannot use wallet or mixed payment. On timeout or uncertain payment status, query the original order and transactions before retrying. Cancellation or switching to wallet payment requires reliable confirmation that an existing online payment is closed. Wallet deductions are returned against the original transaction when cancellation is permitted.
Recharge: use productCode=WALLET_RECHARGE, positive JSON integer amount (for example 1000), and USD (default); omit SKU, package, quantity, product type and business requestId. providerCode must not be INTERNAL. payNo is ignored by this response VO. Only premium real-device purchases require modelSid, obtained from the brand/model endpoint; this applies to wallet, online and mixed payment.
