Onerway
POST

查询账户余额变动流水

受限
查看 Markdown
该接口用于分页查询账户余额变动流水，即收单、资金转出等业务活动在 Onerway Account 中产生的余额增减记录。默认查询 apikey 所属商户的账户流水；平台商户代子商户查询时，通过 onBehalfOf 指定子商户号，返回该子商户账户下符合币种、余额类型、业务类型和余额更新时间范围的流水记录。
访问受限
账户服务 API 的访问权限需经 Onerway 审批后开通。

请求

apikeystring必填
Onerway 分配的账户服务 API key 请求 Header；必须使用与请求域名相同环境的值。
示例：replace_with_account_service_apikey
x-timestampstring必填
请求时间戳；网关使用该 Header 防止请求被重放。
示例：1776931200
约束
规则
时间戳必须在服务端当前时间 10分钟以内；支持 10 位秒级或 13 位毫秒级时间戳。
requestIdstring必填
请求 ID，用于幂等控制和链路追踪。
示例：REQ-TRX-20260423-0001
onBehalfOfstring可选
平台商户代子商户查询时使用的子商户号。未传时，查询 apikey 所属商户的账户流水；传入时，调用方商户必须是该子商户的父商户。
示例：replace_with_sub_merchant_no
currencystring可选
可选的交易币种过滤条件；使用 ISO 4217 三位字母货币代码。
示例：USD
balanceTypestring可选
可选的余额类型过滤条件。
可选值
PAYMENT
Payment 账户余额。
FUNDING
Funding 账户余额。
PENDING_SETTLEMENT
待结算余额。
acntTxnIdstring可选
可选的账户流水 ID 精确过滤条件，使用数字字符串。
示例：replace_with_acnt_txn_id
beginTimestring必填
查询范围的开始时间，按 balanceUpdDate 过滤。
示例：2026-04-01T00:00:00+08:00
约束
规则
使用带时区偏移的 ISO-8601 时间戳，例如 2026-07-20T00:00:00+08:00。
endTimestring必填
查询范围的结束时间，按 balanceUpdDate 过滤。
示例：2026-04-30T23:59:59+08:00
约束
一致性
endTime 不能早于 beginTime。
范围
31天查询时间范围不能超过 31 天。
businessTypestring可选
可选的业务类型过滤条件。
可选值
ACQUIRING
收单业务余额变动。
PAYOUT
付款业务余额变动。
currentnumber可选默认1
当前查询页码；size 由服务端控制，请使用 current 翻页。
示例：1

请求示例

curl -X POST 'https://sandbox-api.onerway.com/account-server/api/v2/account/transactions/query' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "requestId": "REQ-TRX-20260423-0001",
  "currency": "USD",
  "beginTime": "2026-04-01T00:00:00+08:00",
  "endTime": "2026-04-23T23:59:59+08:00",
  "current": 1
}'

响应

respCodestring
标准化响应码；20000 表示成功。
respMsgstring
与 respCode 对应的可读响应信息。
分页账户余额变动流水数据，账户范围由 apikey 和可选的 onBehalfOf 决定。
标准化错误对象；成功响应中该字段为 null，序列化时省略。

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "total": 50,
    "pages": 3,
    "current": 1,
    "list": [
      {
        "acntTxnId": 10001,
        "serviceId": 20001,
        "currency": "USD",
        "balanceType": "PAYMENT",
        "amount": "-100.00",
        "balanceUpdDate": "2026-04-20T10:30:00Z",
        "businessType": "PAYOUT",
        "externalOrderId": "replace_with_external_order_id",
        "remark": "Payout to bank account"
      },
      {
        "acntTxnId": 10002,
        "serviceId": 20002,
        "currency": "USD",
        "balanceType": "PAYMENT",
        "amount": "500.00",
        "balanceUpdDate": "2026-04-19T08:15:00Z",
        "businessType": "ACQUIRING",
        "externalOrderId": "replace_with_external_order_id",
        "remark": "Payment received"
      }
    ]
  }
}
该接口暂未记录错误响应。

查询 Global Account 详情

通过 Global Account ID 或账号查询 Global Account 详情。

按交易单号查询账户流水

按一个或多个交易单号查询关联的账户余额变动记录。