Get Recharge Status
Query the recharge status by recharge order number. Only rechargeStatus=CREDITED means the recharge has been credited; other statuses must not be treated as success. This API attempts to query the payment channel for unconfirmed orders.
Interface Address:
text
/papi/wallet/recharge/getRequest Method:
text
POSTContent-Type:
text
application/jsonHeader Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Access-Key | string | Yes | API access key ID. See API Rules for authentication |
| X-Signature | string | Yes | Signature value, Base64-encoded HMAC-SHA256 result |
| X-Timestamp | string | Yes | Millisecond-level Unix timestamp (13 digits) |
| X-Nonce | string | Yes | Random string, 10~32 lowercase letters + digits |
Body Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| rechargeNo | string | Yes | Recharge order number returned by the Create Recharge API |
Request Example:
json
{
"rechargeNo": "MO202611021000000000001"
}Response Parameters:
| Parameter | Type | Description |
|---|---|---|
| code | integer | Error code. See Error Codes |
| data | object | Response data |
| ├─ rechargeNo | string | Recharge order number, identical to the order number |
| ├─ orderNo | string | Associated order number |
| ├─ amount | string | Recharge amount (cents) |
| ├─ currency | string | Currency code |
| ├─ currencySymbol | string | Currency symbol, e.g. $ for USD |
| ├─ rechargeStatus | string | Recharge status (CREATED-pending confirmation, CREDITED-credited) |
| ├─ creditedTime | integer | Credit time (Unix millisecond timestamp), null when not credited |
| ├─ paymentNo | string | System payment number |
| ├─ paymentStatus | integer | Payment status |
| ├─ payUrl | string | Payment channel redirect URL |
| ├─ qrCodeUrl | string | Payment QR code image URL |
| ├─ payParams | string | Payment channel parameters |
| ├─ balance | string | Current wallet balance (cents) |
| msg | string | Error message |
Response Example:
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": ""
}