订单支付

订单支付。

接口地址：

text

/papi/order/orderPay

请求方式：

text

POST

请求数据类型：

text

application/json

Header 参数：

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

Body 参数：

参数	类型	必填	说明
orderNo	string	是	订单编号
payCode	string	是	支付方式；钱包支付传 `WALLET`
providerCode	string	是	服务商编码；钱包支付传 `INTERNAL`
quantity	integer	否	购买数量，默认 1
payParams	object	否	支付参数
├─ key	object	否	key

请求示例：

json

{
  "orderNo": "string",
  "payCode": "wxpayUs",
  "providerCode": "Wallyt412",
  "quantity": 1,
  "payParams": {
    "key": {}
  }
}

响应参数：

参数	类型	说明
code	integer	错误码，参见错误码说明
data	object	返回数据
├─ orderNo	string	订单编号
├─ qrcodeUrl	string	二维码 URL
├─ payUrl	string	支付链接
├─ payParams	object	支付参数（用于各种支付方式的特定参数，如APP调起支付参数等）
├─├─ key	object	key
├─ payAmount	integer	支付金额（美分）
├─ payAmountYuan	number	支付金额（美元）
├─ walletPayAmount	long	钱包支付金额（美分）
├─ onlinePayAmount	long	在线支付金额（美分）
├─ walletBalance	string	钱包支付后的余额（美分），未使用钱包支付时可为空
├─ currency	string	支付币种（USD）
├─ expireTime	integer	订单过期时间（时间戳）
├─ payMethod	string	支付方式
├─ payIcon	string	支付方式图标
├─ payType	integer	支付类型
├─ payScene	integer	支付方式
├─ transactionId	string	交易 ID
├─ productName	string	商品名称
├─ description	string	订单描述
msg	string	错误提示

响应示例：

json

{
  "code": 0,
  "data": {
    "orderNo": "",
    "qrcodeUrl": "",
    "payUrl": "",
    "payParams": {
      "": {}
    },
    "payAmount": 0,
    "payAmountYuan": 0.0,
    "walletPayAmount": 0,
    "onlinePayAmount": 0,
    "walletBalance": "0",
    "currency": "",
    "expireTime": 0,
    "payMethod": "",
    "payIcon": "",
    "payType": 0,
    "payScene": 0,
    "transactionId": "",
    "productName": "",
    "description": ""
  },
  "msg": ""
}

说明：

使用钱包支付已有订单：payCode=WALLET、providerCode=INTERNAL，仅适用于符合钱包支付规则的未完成订单。
不能对钱包充值订单使用钱包支付，也不能将已存在的混合支付订单直接转为纯钱包支付。
若订单已有在线付款且可能仍可收款，须先可靠确认该付款已关闭后再操作。

钱包支付规则

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

订单支付 ​

钱包支付规则 ​

订单支付

钱包支付规则