创建充值

创建钱包充值单并返回支付信息。推荐使用商品下单的 productCode=WALLET_RECHARGE 流程；当前也提供该钱包专用入口。

接口地址：

text

/papi/wallet/recharge/create

请求方式：

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 参数：

参数	类型	必填	说明
amount	string	是	充值金额，正整数字符串，单位为美分（如 `1000` 表示 10 美元），不能传小数
currency	string	否	币种代码，仅支持 USD
payCode	string	是	支付方式编码，取实际启用的在线支付方式
providerCode	string	是	支付服务商编码，取本站服务商编码

请求示例：

json

{
  "amount": "1000",
  "currency": "USD",
  "payCode": "实际支付方式编码",
  "providerCode": "实际服务商编码"
}

响应参数：

参数	类型	说明
code	integer	错误码，参见错误码说明
data	object	返回数据
├─ rechargeNo	string	充值订单号，与 `orderNo` 相同
├─ orderNo	string	关联订单号
├─ amount	string	充值金额，单位为美分
├─ currency	string	币种代码
├─ currencySymbol	string	货币符号，如 USD 的 `$`
├─ rechargeStatus	string	充值状态：`CREATED` 待确认到账，`CREDITED` 已入账
├─ creditedTime	long	充值入账时间，Unix 毫秒时间戳
├─ paymentNo	string	系统支付单号
├─ paymentStatus	integer	支付单状态
├─ payUrl	string	支付渠道提供的跳转链接
├─ qrCodeUrl	string	支付二维码链接
├─ payParams	string	支付渠道参数字符串，按渠道而异
msg	string	错误提示

响应示例：

json

{
  "code": 0,
  "data": {
    "rechargeNo": "",
    "orderNo": "",
    "amount": "1000",
    "currency": "USD",
    "currencySymbol": "$",
    "rechargeStatus": "CREATED",
    "creditedTime": null,
    "paymentNo": "",
    "paymentStatus": 0,
    "payUrl": "",
    "qrCodeUrl": "",
    "payParams": null
  },
  "msg": ""
}

说明：

rechargeNo 与订单号相同，可用于查询充值状态。
CREATED 表示尚未确认到账，CREDITED 才表示已有充值入账流水。
充值不支持钱包支付或混合支付，payCode 不得为 WALLET。

创建充值 ​

创建充值