POST
导出每日账户账单
受限该接口用于按指定日期、币种和业务类型导出每日账户账单 CSV。
访问受限
账户服务 API 的访问权限需经 Onerway 审批后开通。
请求
apikeyOnerway 分配的账户服务 API key 请求 Header;必须使用与请求域名相同环境的值。
示例:
replace_with_account_service_apikeyx-timestamp请求时间戳;网关使用该 Header 防止请求被重放。
示例:
1776931200约束
- 规则
- 时间戳必须在服务端当前时间 10分钟以内;支持 10 位秒级或 13 位毫秒级时间戳。
requestId请求 ID,用于幂等控制和链路追踪。
示例:
REQ-STMT-20260720-0001onBehalfOf平台商户代子商户导出时使用的子商户号;调用方商户必须是子商户的父商户。
示例:
replace_with_sub_merchant_nodate账单日期,使用
yyyyMMdd 格式。示例:
20260720约束
- 规则
- 使用
yyyyMMdd格式,例如20260720。
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`。
响应
respCodeJSON 错误响应中的标准化响应码。
respMsg与
respCode 对应的可读响应信息。file{ csv }成功响应返回 CSV 文件流,
Content-Type: text/csv; charset=UTF-8;Content-Disposition Header 形如 attachment; filename=statement_{date}_{currency}.csv。请将 UTF-8 编码内容保存为 .csv 文件。error{ code, declineCode, ... }标准化错误对象;仅在 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"
}
]
}
}
}该接口暂未记录错误响应。