Fund Transaction Page

Query all wallet fund transactions with pagination, including recharges, debits and order cancel refunds. Filterable by currency, transaction type, business type, associated order number and time range. Filters are exact-match.

Interface Address:

/papi/wallet/transaction/page

Request Method:

POST

Content-Type:

application/json

Header 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
type	integer	No	Transaction type: 1 recharge, 2 debit, 3 order cancel refund
bizType	string	No	Transaction business type, see notes below
orderNo	string	No	Associated order number
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:

{
  "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	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
├─├─ 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:

{
  "code": 0,
  "data": {
    "list": [
      {
        "transactionNo": "",
        "type": 2,
        "direction": "DEBIT",
        "bizType": "ORDER_PAY",
        "bizNo": "",
        "orderNo": "MO202611021000000000002",
        "payCode": "WALLET",
        "amount": "400",
        "balanceBefore": "2250",
        "balanceAfter": "1850",
        "currency": "USD",
        "currencySymbol": "$",
        "ctime": ""
      }
    ],
    "total": 0
  },
  "msg": ""
}

Notes:

• Common bizType values: USER_RECHARGE user recharge, ADMIN_RECHARGE admin recharge, ADMIN_DEBIT admin debit, ORDER_PAY order payment, AUTO_RENEW auto renewal, ORDER_CANCEL_RETURN order cancel refund.
• Admin remarks, operators, merchant and channel credentials are cleared on the consumer side.
• The time range must not be reversed or exceed 90 days.