Skip to content

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/get

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID. See API Rules for authentication
X-SignaturestringYesSignature value, Base64-encoded HMAC-SHA256 result
X-TimestampstringYesMillisecond-level Unix timestamp (13 digits)
X-NoncestringYesRandom string, 10~32 lowercase letters + digits

Body Parameters:

ParameterTypeRequiredDescription
rechargeNostringYesRecharge order number returned by the Create Recharge API

Request Example:

json
{
  "rechargeNo": "MO202611021000000000001"
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectResponse data
├─ rechargeNostringRecharge order number, identical to the order number
├─ orderNostringAssociated order number
├─ amountstringRecharge amount (cents)
├─ currencystringCurrency code
├─ currencySymbolstringCurrency symbol, e.g. $ for USD
├─ rechargeStatusstringRecharge status (CREATED-pending confirmation, CREDITED-credited)
├─ creditedTimeintegerCredit time (Unix millisecond timestamp), null when not credited
├─ paymentNostringSystem payment number
├─ paymentStatusintegerPayment status
├─ payUrlstringPayment channel redirect URL
├─ qrCodeUrlstringPayment QR code image URL
├─ payParamsstringPayment channel parameters
├─ balancestringCurrent wallet balance (cents)
msgstringError 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": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center