查询充值状态

按充值订单号查询充值单状态及到账信息，并返回当前钱包余额。接口会尝试对未确认订单查单。

接口地址：

text

/papi/wallet/recharge/get

请求方式：

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

参数	类型	必填	说明
rechargeNo	string	是	充值订单号，取创建充值返回的 `rechargeNo`

请求示例：

json

{
  "rechargeNo": "MO202611021000000000001"
}

响应参数：

参数	类型	说明
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	支付渠道参数字符串，按渠道而异
├─ balance	string	当前钱包余额，单位为美分
msg	string	错误提示

响应示例：

json

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

说明：

仅 rechargeStatus=CREDITED 表示充值已到账，其他状态不应视为充值成功。
充值最终到账以本接口的 CREDITED 为准。

查询充值状态 ​

查询充值状态