Onerway
POST

导出每日账户账单

受限
该接口用于按指定日期、币种和业务类型导出每日账户账单 CSV。
访问受限
账户服务 API 的访问权限需经 Onerway 审批后开通。

请求

apikey
Onerway 分配的账户服务 API key 请求 Header;必须使用与请求域名相同环境的值。
示例:
x-timestamp
请求时间戳;网关使用该 Header 防止请求被重放。
示例:
约束
规则
时间戳必须在服务端当前时间 10分钟以内;支持 10 位秒级或 13 位毫秒级时间戳。
requestId
请求 ID,用于幂等控制和链路追踪。
示例:
onBehalfOf
平台商户代子商户导出时使用的子商户号;调用方商户必须是子商户的父商户。
示例:
date
账单日期,使用 yyyyMMdd 格式。
示例:
约束
规则
使用 yyyyMMdd 格式,例如 20260720。
currency
账单币种;使用 ISO 4217 三位字母货币代码。
示例:
businessType
账单导出的业务类型;缺省值为 PAYOUT。
可选值
ACQUIRING
收单业务账单。
PAYOUT
付款业务账单。
BAAS
BaaS 业务账单。

请求示例

curl -X POST 'https://sandbox-api.onerway.com/account-server/api/v2/account/statement/daily/export' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "requestId": "REQ-STMT-20260720-0001",
  "date": "20260720",
  "currency": "USD",
  "businessType": "PAYOUT"
}'

响应表示

  • 媒体类型
    text/csv
    Schema
    类型 string格式 binary

    响应头

    Content-Dispositionstring
    提供下载文件名,取值形如 `attachment; filename=statement_{date}_{currency}.csv`。

响应

respCode
JSON 错误响应中的标准化响应码。
respMsg
与 respCode 对应的可读响应信息。
成功响应返回 CSV 文件流,Content-Type: text/csv; charset=UTF-8;Content-Disposition Header 形如 attachment; filename=statement_{date}_{currency}.csv。请将 UTF-8 编码内容保存为 .csv 文件。
标准化错误对象;仅在 CSV 响应尚未提交时返回;一旦响应已写入,则失败仅记录日志,调用方收到已部分写入的 CSV。

响应示例

{
  "file": {
    "csv": {
      "statementHeader": {
        "Merchantid": "replace_with_merchant_no",
        "Date": "GMT+8 2026/7/20",
        "Currency": "USD"
      },
      "summaryRows": [
        {
          "Balancetype": "Total Balance",
          "Openingbalance": "3000.00",
          "Movementamount": "400.00",
          "Endingbalance": "3400.00"
        },
        {
          "Balancetype": "Available",
          "Openingbalance": "2500.00",
          "Movementamount": "500.00",
          "Endingbalance": "3000.00"
        }
      ],
      "detailRows": [
        {
          "Time": "2026/7/20 10:30:00",
          "Balancetype": "Available",
          "Serialnumber": "20001",
          "Activitytype": "Payout",
          "Moveamount": "-100.00",
          "RelatedtransationID": "replace_with_external_order_id",
          "Remark": "Payout to bank account"
        }
      ]
    }
  }
}
该接口暂未记录错误响应。