查询充值状态
根据充值订单号查询充值状态;仅 rechargeStatus=CREDITED 表示已到账,其他状态不能视为充值成功。接口会对未确认订单尝试向支付渠道查单。
接口地址:
text
/papi/wallet/recharge/get请求方式:
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 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| rechargeNo | string | 是 | 充值订单号,取创建充值接口返回的 rechargeNo |
请求示例:
json
{
"rechargeNo": "MO202611021000000000001"
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| 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 | 支付渠道参数 |
| ├─ balance | string | 当前钱包余额(美分) |
| msg | string | 错误提示 |
响应示例:
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": ""
}