Skip to content

Place Order ​

Place order.

Interface Address:

text
/papi/order/create

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID. See API Rules for authentication
X-SignaturestringYesSignature value, Base64-encoded HMAC-SHA256 result
X-TimestampstringYesMillisecond-level Unix timestamp (13 digits)
X-NoncestringYesRandom string, 10~32 lowercase letters + digits

Body Parameters:

ParameterTypeRequiredDescription
productCodestringYesProduct code
packageCodestringYesPackage code
skuCodestringYesSKU code
quantityintegerNoPurchase quantity, default 1
payCodestringYesPayment method
providerCodestringYesProvider code
modelSidstringNoModel SID, required when purchasing High-end Real Devices (customizeType=2)
payParamsobjectNoPayment parameters
├─ keyobjectNokey

Request Example:

json
{
  "productCode": "CLOUD_PHONE",
  "packageCode": "s2e9pd6r6x",
  "skuCode": "gy5zp58kt3",
  "quantity": 1,
  "payCode": "wxpayUs",
  "providerCode": "Wallyt412",
  "modelSid": "string",
  "payParams": {
    "key": {}
  }
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectResponse data
├─ orderNostringOrder number
├─ qrcodeUrlstringQR code URL
├─ payUrlstringPayment URL
├─ payParamsobjectPayment parameters (specific parameters for various payment methods, such as APP payment parameters)
├─├─ keyobjectkey
├─ payAmountintegerPayment amount (cents)
├─ payAmountYuannumberPayment amount (yuan)
├─ currencystringCurrency unit
├─ expireTimeintegerOrder expiration time (timestamp)
├─ payMethodstringPayment method
├─ payIconstringPayment method icon
├─ payTypeintegerPayment type
├─ paySceneintegerPayment scene
├─ transactionIdstringTransaction ID
├─ productNamestringProduct name
├─ descriptionstringOrder description
msgstringError message

Response Example:

json
{
  "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.

Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center