Skip to content

查询充值状态 ​

根据充值订单号查询充值状态;仅 rechargeStatus=CREDITED 表示已到账,其他状态不能视为充值成功。接口会对未确认订单尝试向支付渠道查单。

接口地址:

text
/papi/wallet/recharge/get

请求方式:

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

参数类型必填说明
rechargeNostring是充值订单号,取创建充值接口返回的 rechargeNo

请求示例:

json
{
  "rechargeNo": "MO202611021000000000001"
}

响应参数:

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

响应示例:

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

QTPhone 帮助中心