Onerway
POST

按交易单号查询账户流水

受限
查看 Markdown
已知交易单号时，可使用该接口查询关联的账户流水记录。
访问受限
账户服务 API 的访问权限需经 Onerway 审批后开通。

请求

apikeystring必填
Onerway 分配的账户服务 API key 请求 Header；必须使用与请求域名相同环境的值。
示例：replace_with_account_service_apikey
x-timestampstring必填
请求时间戳；网关使用该 Header 防止请求被重放。
示例：1776931200
约束
规则
时间戳必须在服务端当前时间 10分钟以内；支持 10 位秒级或 13 位毫秒级时间戳。
requestIdstring必填
请求 ID，用于幂等控制和链路追踪。
示例：REQ-TRX-20260423-0002
onBehalfOfstring可选
平台商户代子商户查询时使用的子商户号；调用方商户必须是子商户的父商户。
示例：replace_with_sub_merchant_no
serviceIdsarray<integer>必填
用于定位关联余额变动记录的交易单号列表。
示例：[20001,20002,20003]
约束
范围
1100个元素列表不能为空，且最多包含 100 个交易单号。

请求示例

curl -X POST 'https://sandbox-api.onerway.com/account-server/api/v2/account/transactions/service/query' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "requestId": "REQ-TRX-20260423-0002",
  "serviceIds": [
    20001,
    20002,
    20003
  ]
}'

响应

respCodestring
标准化响应码；20000 表示成功。
respMsgstring
与 respCode 对应的可读响应信息。
按 serviceIds[] 匹配的账户流水数据。
标准化错误对象；成功响应中该字段为 null，序列化时省略。

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "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"
      }
    ]
  }
}
该接口暂未记录错误响应。

查询账户余额变动流水

查询调用方商户账户或指定子商户账户的余额变动记录。

查询账户余额

查询指定单一币种的账户余额明细。