Skip to content

商品下单 ​

商品下单。

接口地址:

text
/papi/order/create

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

参数类型必填说明
productCodestring是商品 code
packageCodestring是套餐 Code
skuCodestring是Sku Code
quantityinteger否购买数量,默认 1
payCodestring是支付方式
providerCodestring是服务商编码
modelSidstring否机型 sid,购买高端真机(customizeType=2)时必传
payParamsobject否支付参数
├─ keyobject否key

请求示例:

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

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ orderNostring订单编号
├─ qrcodeUrlstring二维码 URL
├─ payUrlstring支付链接
├─ payParamsobject支付参数(用于各种支付方式的特定参数,如APP调起支付参数等)
├─├─ keyobjectkey
├─ payAmountinteger支付金额(分)
├─ payAmountYuannumber支付金额(元)
├─ currencystring支付单位
├─ expireTimeinteger订单过期时间(时间戳)
├─ payMethodstring支付方式
├─ payIconstring支付方式图标
├─ payTypeinteger支付类型
├─ paySceneinteger支付方式
├─ transactionIdstring交易 ID
├─ productNamestring商品名称
├─ descriptionstring订单描述
msgstring错误提示

响应示例:

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": ""
}

钱包支付规则 ​

纯钱包支付使用 payCode=WALLET、providerCode=INTERNAL;混合支付使用实际在线渠道并传 JSON 整数 walletPayAmount(美分),须大于 0 且小于后台计算的实付总额,不提交 onlinePayAmount。充值订单不能使用钱包或混合支付。支付超时或结果待确认时,先查询原订单和流水;取消或改用钱包支付前,须可靠确认已有在线付款已关闭。符合取消条件时,钱包扣款按原流水返还。

充值下单:productCode=WALLET_RECHARGE,amount 为 JSON 正整数(如 1000),默认 USD;无需 SKU、套餐、数量、productType 或业务 requestId,providerCode 不得为 INTERNAL。响应 VO 忽略 payNo,不可依赖其返回。仅购买高端真机必须传 modelSid,从获取品牌机型接口取得所选机型 SID;钱包、在线及混合支付均适用,不可用机型名称或已有云机 SID 代替。

Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone 帮助中心