Skip to content

Recharge Transaction Page ​

Query credited recharge transactions with pagination. Filterable by currency, recharge source, status and time range.

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 and digits

Body Parameters:

ParameterTypeRequiredDescription
pageNointegerNoPage number, starting from 1. Defaults to 1
pageSizeintegerNoPage size. Defaults to 10, max 1000
currencystringNoCurrency code; only USD is supported
sourcestringNoRecharge source: USER user recharge, ADMIN admin recharge
statusstringNoTransaction status; credited transactions correspond to CREDITED
beginTimelongNoQuery start time, Unix timestamp in milliseconds. Defaults to 30 days before endTime
endTimelongNoQuery 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:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectReturn data
├─ listarray[object]Data list
├─├─ transactionNostringFund transaction number
├─├─ typeintegerTransaction type: 1 recharge, 2 debit, 3 order cancel refund
├─├─ directionstringFund direction: CREDIT incoming, DEBIT outgoing
├─├─ bizTypestringTransaction business type, e.g. USER_RECHARGE, ADMIN_RECHARGE
├─├─ bizNostringAssociated business number
├─├─ orderNostringAssociated order number
├─├─ payCodestringPayment method code
├─├─ amountstringAmount, in cents
├─├─ balanceBeforestringWallet balance before this transaction
├─├─ balanceAfterstringWallet balance after this transaction
├─├─ currencystringCurrency code
├─├─ currencySymbolstringCurrency symbol, e.g. $ for USD
├─├─ ctimestringTransaction creation time
├─ 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": "1250",
        "balanceAfter": "2250",
        "currency": "USD",
        "currencySymbol": "$",
        "ctime": ""
      }
    ],
    "total": 0
  },
  "msg": ""
}

Notes:

  • This API only queries transactions with type=1 (recharge); credited transactions correspond to CREDITED, other non-empty statuses return no matching records.
  • The time range must not be reversed or exceed 90 days.

OpenAPI Docs