Recharge Transaction Page
Query credited recharge transactions with pagination. Filterable by currency, recharge source, status and time range.
Interface Address:
text
/papi/wallet/recharge/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 and digits |
Body Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| pageNo | integer | No | Page number, starting from 1. Defaults to 1 |
| pageSize | integer | No | Page size. Defaults to 10, max 1000 |
| currency | string | No | Currency code; only USD is supported |
| source | string | No | Recharge source: USER user recharge, ADMIN admin recharge |
| status | string | No | Transaction status; credited transactions correspond to CREDITED |
| beginTime | long | No | Query start time, Unix timestamp in milliseconds. Defaults to 30 days before endTime |
| endTime | long | No | Query end time, Unix timestamp in milliseconds. Defaults to current time |
Request Example:
json
{
"pageNo": 1,
"pageSize": 10,
"currency": "USD",
"source": "USER",
"status": "CREDITED",
"beginTime": 1793491200000,
"endTime": 1793577600000
}Response Parameters:
| Parameter | Type | Description |
|---|---|---|
| code | integer | Error code. See Error Codes |
| data | object | Return data |
| ├─ list | array[object] | Data list |
| ├─├─ transactionNo | string | Fund transaction number |
| ├─├─ type | integer | Transaction type: 1 recharge, 2 debit, 3 order cancel refund |
| ├─├─ direction | string | Fund direction: CREDIT incoming, DEBIT outgoing |
| ├─├─ bizType | string | Transaction business type, e.g. USER_RECHARGE, ADMIN_RECHARGE |
| ├─├─ bizNo | string | Associated business number |
| ├─├─ orderNo | string | Associated order number |
| ├─├─ payCode | string | Payment method code |
| ├─├─ amount | string | Amount, in cents |
| ├─├─ balanceBefore | string | Wallet balance before this transaction |
| ├─├─ balanceAfter | string | Wallet balance after this transaction |
| ├─├─ currency | string | Currency code |
| ├─├─ currencySymbol | string | Currency symbol, e.g. $ for USD |
| ├─├─ ctime | string | Transaction creation time |
| ├─ total | integer | Total count |
| msg | string | Error message |
Response Example:
json
{
"code": 0,
"data": {
"list": [
{
"transactionNo": "",
"type": 1,
"direction": "CREDIT",
"bizType": "USER_RECHARGE",
"bizNo": "",
"orderNo": "",
"payCode": "",
"amount": "1000",
"balanceBefore": "1250",
"balanceAfter": "2250",
"currency": "USD",
"currencySymbol": "$",
"ctime": ""
}
],
"total": 0
},
"msg": ""
}Notes:
- This API only queries transactions with
type=1(recharge); credited transactions correspond toCREDITED, other non-empty statuses return no matching records. - The time range must not be reversed or exceed 90 days.
