Skip to content

Recharge Record Page ​

Paginated query of wallet recharge records. This API always queries recharge-type records (type=1); credited records correspond to status CREDITED.

Interface Address:

text
/papi/wallet/recharge/page

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
pageNointegerNoPage number, starting from 1, default 1
pageSizeintegerNoPage size, max 1000, default 10
currencystringNoCurrency code
sourcestringNoRecharge source (USER-user recharge, ADMIN-admin recharge)
statusstringNoRecord status; credited records correspond to CREDITED, passing any other non-empty status returns no matching records
beginTimeintegerNoQuery start time (Unix millisecond timestamp), default 30 days before endTime
endTimeintegerNoQuery end time (Unix millisecond timestamp), default current time; the range must not be reversed and must not exceed 90 days

Request Example:

json
{
  "pageNo": 1,
  "pageSize": 10,
  "currency": "USD",
  "source": "USER",
  "status": "CREDITED",
  "beginTime": 1793491200000,
  "endTime": 1793577600000
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectResponse data
├─ listarray[object]Data list
├─├─ transactionNostringTransaction number
├─├─ typeintegerTransaction type (1-recharge, 2-debit, 3-order cancellation refund)
├─├─ directionstringFund direction (CREDIT-in, DEBIT-out)
├─├─ bizTypestringBusiness type
├─├─ bizNostringAssociated business number
├─├─ orderNostringAssociated order number, empty for admin bookkeeping without an order
├─├─ payCodestringPayment method code
├─├─ amountstringAmount (cents)
├─├─ balanceBeforestringBalance before the change (cents)
├─├─ balanceAfterstringBalance after the change (cents)
├─├─ currencystringCurrency code
├─├─ currencySymbolstringCurrency symbol, e.g. $ for USD
├─├─ ctimestringCreation time (Unix millisecond timestamp)
├─ totalintegerTotal count
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": {
    "list": [
      {
        "transactionNo": "",
        "type": 1,
        "direction": "CREDIT",
        "bizType": "USER_RECHARGE",
        "bizNo": "",
        "orderNo": "",
        "payCode": "",
        "amount": "1000",
        "balanceBefore": "250",
        "balanceAfter": "1250",
        "currency": "USD",
        "currencySymbol": "$",
        "ctime": "1793577600000"
      }
    ],
    "total": 1
  },
  "msg": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center