查询充值流水

分页查询已到账的充值流水，可按币种、充值来源、状态和时间范围筛选。

接口地址：

text

/papi/wallet/recharge/page

请求方式：

text

POST

请求数据类型：

text

application/json

Header 参数：

参数	类型	必填	说明
X-Access-Key	string	是	API 访问密钥 ID，鉴权方式见接口规则
X-Signature	string	是	签名值，Base64 编码的 HMAC-SHA256 计算结果
X-Timestamp	string	是	毫秒级 Unix 时间戳（13 位）
X-Nonce	string	是	随机字符串，10~32 位小写字母+数字

Body 参数：

参数	类型	必填	说明
pageNo	integer	否	页码，从 1 开始，默认 1
pageSize	integer	否	每页数量，默认 10，最大 1000
currency	string	否	币种代码，仅支持 USD
source	string	否	充值来源：`USER` 用户充值，`ADMIN` 后台充值
status	string	否	流水状态，已到账流水对应 `CREDITED`
beginTime	long	否	查询起始时间，Unix 毫秒时间戳，默认结束时间前 30 天
endTime	long	否	查询结束时间，Unix 毫秒时间戳，默认当前时间

请求示例：

json

{
  "pageNo": 1,
  "pageSize": 10,
  "currency": "USD",
  "source": "USER",
  "status": "CREDITED",
  "beginTime": 1793491200000,
  "endTime": 1793577600000
}

响应参数：

参数	类型	说明
code	integer	错误码，参见错误码说明
data	object	返回数据
├─ list	array[object]	数据列表
├─├─ transactionNo	string	资金流水号
├─├─ type	integer	流水类型：1 充值、2 扣款、3 订单取消退回
├─├─ direction	string	资金方向：`CREDIT` 入账、`DEBIT` 扣款
├─├─ bizType	string	流水业务类型，如 `USER_RECHARGE`、`ADMIN_RECHARGE`
├─├─ bizNo	string	流水关联的业务编号
├─├─ orderNo	string	关联订单号
├─├─ payCode	string	支付方式编码
├─├─ amount	string	金额，单位为美分
├─├─ balanceBefore	string	本次流水变动前余额
├─├─ balanceAfter	string	本次流水变动后余额
├─├─ currency	string	币种代码
├─├─ currencySymbol	string	货币符号，如 USD 的 `$`
├─├─ ctime	string	流水创建时间
├─ total	integer	总量
msg	string	错误提示

响应示例：

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": ""
}

说明：

本接口固定查询 type=1（充值）的流水，已到账流水对应 CREDITED，传入其他非空状态不会返回匹配流水。
时间范围不得倒置或超过 90 天。

查询充值流水 ​

查询充值流水