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/pageRequest 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 |
|---|---|---|---|
| pageNo | integer | No | Page number, starting from 1, default 1 |
| pageSize | integer | No | Page size, max 1000, default 10 |
| currency | string | No | Currency code, exact match |
| type | integer | No | Transaction type (1-recharge, 2-debit, 3-order cancellation refund) |
| bizType | string | No | Business 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) |
| orderNo | string | No | Associated order number, exact match |
| beginTime | integer | No | Query start time (Unix millisecond timestamp), default 30 days before endTime |
| endTime | integer | No | Query 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:
| Parameter | Type | Description |
|---|---|---|
| code | integer | Error code. See Error Codes |
| data | object | Response data |
| ├─ list | array[object] | Data list |
| ├─├─ transactionNo | string | Transaction number |
| ├─├─ type | integer | Transaction type (1-recharge, 2-debit, 3-order cancellation refund) |
| ├─├─ direction | string | Fund direction (CREDIT-in, DEBIT-out) |
| ├─├─ bizType | string | Business type |
| ├─├─ bizNo | string | Associated business number |
| ├─├─ orderNo | string | Associated order number, empty for admin bookkeeping without an order |
| ├─├─ payCode | string | Payment method code |
| ├─├─ amount | string | Amount (cents) |
| ├─├─ balanceBefore | string | Balance before the change (cents) |
| ├─├─ balanceAfter | string | Balance after the change (cents) |
| ├─├─ currency | string | Currency code |
| ├─├─ currencySymbol | string | Currency symbol, e.g. $ for USD |
| ├─├─ ctime | string | Creation time (Unix millisecond timestamp) |
| ├─ total | integer | Total count |
| msg | string | Error 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": ""
}