Skip to content

创建充值 ​

创建钱包充值订单,返回支付链接与支付参数;充值不支持钱包支付或混合支付。推荐通过商品下单接口以 productCode=WALLET_RECHARGE 创建充值订单,本接口为钱包专用入口。

接口地址:

text
/papi/wallet/recharge/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 参数:

参数类型必填说明
amountstring是充值金额(美分),正整数字符串,不能传小数
currencystring否币种代码,仅支持 USD,默认 USD
payCodestring是在线支付方式编码,取实际启用的支付方式
providerCodestring是支付服务商编码

请求示例:

json
{
  "amount": "1000",
  "currency": "USD",
  "payCode": "wxpayUs",
  "providerCode": "Wallyt412"
}

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ rechargeNostring充值订单号,与订单号相同
├─ orderNostring关联订单号
├─ amountstring充值金额(美分)
├─ currencystring币种代码
├─ currencySymbolstring货币符号,如 USD 的 $
├─ rechargeStatusstring充值状态(CREATED-待确认,CREDITED-已入账)
├─ creditedTimeinteger充值入账时间(Unix 毫秒时间戳),未入账时为 null
├─ paymentNostring系统支付单号
├─ paymentStatusinteger支付单状态
├─ payUrlstring支付渠道跳转链接
├─ qrCodeUrlstring支付二维码图片链接
├─ payParamsstring支付渠道参数
msgstring错误提示

响应示例:

json
{
  "code": 0,
  "data": {
    "rechargeNo": "MO202611021000000000001",
    "orderNo": "MO202611021000000000001",
    "amount": "1000",
    "currency": "USD",
    "currencySymbol": "$",
    "rechargeStatus": "CREATED",
    "creditedTime": null,
    "paymentNo": "",
    "paymentStatus": 0,
    "payUrl": "",
    "qrCodeUrl": "",
    "payParams": ""
  },
  "msg": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone 帮助中心