创建充值
创建钱包充值订单,返回支付链接与支付参数;充值不支持钱包支付或混合支付。推荐通过商品下单接口以 productCode=WALLET_RECHARGE 创建充值订单,本接口为钱包专用入口。
接口地址:
text
/papi/wallet/recharge/create请求方式:
text
POST请求数据类型:
text
application/jsonHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Body 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | string | 是 | 充值金额(美分),正整数字符串,不能传小数 |
| currency | string | 否 | 币种代码,仅支持 USD,默认 USD |
| payCode | string | 是 | 在线支付方式编码,取实际启用的支付方式 |
| providerCode | string | 是 | 支付服务商编码 |
请求示例:
json
{
"amount": "1000",
"currency": "USD",
"payCode": "wxpayUs",
"providerCode": "Wallyt412"
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 返回数据 |
| ├─ rechargeNo | string | 充值订单号,与订单号相同 |
| ├─ orderNo | string | 关联订单号 |
| ├─ amount | string | 充值金额(美分) |
| ├─ currency | string | 币种代码 |
| ├─ currencySymbol | string | 货币符号,如 USD 的 $ |
| ├─ rechargeStatus | string | 充值状态(CREATED-待确认,CREDITED-已入账) |
| ├─ creditedTime | integer | 充值入账时间(Unix 毫秒时间戳),未入账时为 null |
| ├─ paymentNo | string | 系统支付单号 |
| ├─ paymentStatus | integer | 支付单状态 |
| ├─ payUrl | string | 支付渠道跳转链接 |
| ├─ qrCodeUrl | string | 支付二维码图片链接 |
| ├─ payParams | string | 支付渠道参数 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": {
"rechargeNo": "MO202611021000000000001",
"orderNo": "MO202611021000000000001",
"amount": "1000",
"currency": "USD",
"currencySymbol": "$",
"rechargeStatus": "CREATED",
"creditedTime": null,
"paymentNo": "",
"paymentStatus": 0,
"payUrl": "",
"qrCodeUrl": "",
"payParams": ""
},
"msg": ""
}