Skip to content

资金流水分页 ​

分页查询钱包全部资金流水(充值、扣款、退回),查询条件为精确匹配;管理备注、操作人、商户和渠道凭证等敏感信息不返回。

接口地址:

text
/papi/wallet/transaction/page

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

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

Body 参数:

参数类型必填说明
pageNointeger否页码,从 1 开始,默认 1
pageSizeinteger否每页条数,最大值为 1000,默认 10
currencystring否币种代码,精确匹配
typeinteger否流水类型(1-充值,2-扣款,3-订单取消退回)
bizTypestring否流水业务类型(USER_RECHARGE-用户充值,ADMIN_RECHARGE-后台充值,ADMIN_DEBIT-后台扣费,ORDER_PAY-订单支付,AUTO_RENEW-自动续费,ORDER_CANCEL_RETURN-取消订单返还)
orderNostring否关联订单号,精确匹配
beginTimeinteger否查询起始时间(Unix 毫秒时间戳),默认结束时间前 30 天
endTimeinteger否查询结束时间(Unix 毫秒时间戳),默认当前时间;时间范围不能倒置且不能超过 90 天

请求示例:

json
{
  "pageNo": 1,
  "pageSize": 10,
  "currency": "USD",
  "type": 2,
  "bizType": "ORDER_PAY",
  "orderNo": "MO202611021000000000002",
  "beginTime": 1793491200000,
  "endTime": 1793577600000
}

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ listarray[object]数据列表
├─├─ transactionNostring资金流水号
├─├─ typeinteger流水类型(1-充值,2-扣款,3-订单取消退回)
├─├─ directionstring资金方向(CREDIT-入账,DEBIT-扣款)
├─├─ bizTypestring流水业务类型
├─├─ bizNostring流水关联的业务编号
├─├─ orderNostring关联订单号,无订单的后台记账为空
├─├─ payCodestring支付方式编码
├─├─ amountstring金额(美分)
├─├─ balanceBeforestring变动前余额(美分)
├─├─ balanceAfterstring变动后余额(美分)
├─├─ currencystring币种代码
├─├─ currencySymbolstring货币符号,如 USD 的 $
├─├─ ctimestring创建时间(Unix 毫秒时间戳)
├─ totalinteger总量
msgstring错误提示

响应示例:

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": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone 帮助中心