Skip to content

Transaction Record Page ​

Paginated query of all wallet fund records (recharge, debit, refund); filter conditions are exact matches. Sensitive information such as admin remarks, operators, merchants, and channel credentials is not returned.

Interface Address:

text
/papi/wallet/transaction/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, exact match
typeintegerNoTransaction type (1-recharge, 2-debit, 3-order cancellation refund)
bizTypestringNoBusiness type (USER_RECHARGE-user recharge, ADMIN_RECHARGE-admin recharge, ADMIN_DEBIT-admin debit, ORDER_PAY-order payment, AUTO_RENEW-auto renewal, ORDER_CANCEL_RETURN-order cancellation refund)
orderNostringNoAssociated order number, exact match
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",
  "type": 2,
  "bizType": "ORDER_PAY",
  "orderNo": "MO202611021000000000002",
  "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": 2,
        "direction": "DEBIT",
        "bizType": "ORDER_PAY",
        "bizNo": "",
        "orderNo": "MO202611021000000000002",
        "payCode": "WALLET",
        "amount": "400",
        "balanceBefore": "1250",
        "balanceAfter": "850",
        "currency": "USD",
        "currencySymbol": "$",
        "ctime": "1793577600000"
      }
    ],
    "total": 1
  },
  "msg": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center