Onerway
快速开始

概览

账户余额、账户流水、账户账单与 Global Account（全球收付账户）管理服务。
查看 Markdown

Onerway Account 面向需要管理账户资金、查询余额变动、导出账单以及使用 Global Account（全球收付账户）能力的商户。你可以通过账户服务 API 查询多币种余额、追踪账户流水、导出每日账单，并在已开通权限后创建和查询 Global Account。

新接入账户余额、账户流水和账户账单接口时，请优先使用当前账户服务接口。页面左侧 API Reference 已按“账户余额”“账户交易”“账户账单”和 Global Account（全球收付账户）相关分组展示，废弃接口不会作为当前接口入口展示。

能力范围

能力适用场景推荐入口
账户余额查询账户各币种余额汇总，或读取指定币种余额明细。查询账户余额总览
账户交易查询账户余额变动流水，或按交易单号反查关联流水。查询账户流水
账户账单按日期导出账户账单 CSV，用于财务核对。导出每日账户账单
Global Account（全球收付账户）创建 Global Account，查询开户资料、账户状态和通知 URL。创建 Global Account
响应码根据账户服务响应码定位原因并决定排查动作。响应码

接入路径

完成接入准备

先准备账户服务请求域名、apikey、x-timestamp、出口 IP 白名单和接口权限。账户服务 Base URL 当前为：

环境Base URL
Sandboxhttps://sandbox-api.onerway.com/account-server
Productionhttps://api.onerway.com/account-server

接入准备 页面包含完整请求 Header、示例 apikey、10分钟时间戳窗口和接口地址清单。

查询账户余额

接入完成后，通常先调用余额接口验证账户权限和币种数据。

查询账户流水

账户流水用于定位余额变化来源，也可以把账户资金变动与业务订单、打款或资金转出记录关联起来。

导出账户账单

财务对账或归档时，使用 导出每日账户账单 下载指定日期的 CSV 文件。建议按自然日归档，并保留请求参数与返回文件的对应关系，方便后续追溯。

使用 Global Account

如果需要账户开通、收款或资金转出场景，请先确认 Global Account 能力已开通，再调用：

接口字段差异

当前账户余额、账户流水和账户账单接口使用新的账户服务响应结构：

项目当前账户服务接口
请求鉴权apikey Header
防重放 Headerx-timestamp
成功响应码respCode = 20000
响应信息字段respMsg
错误对象error
幂等字段requestId，10分钟内用于安全重试

Global Account 接口仍以当前接口页面展示的字段为准。调用时请不要混用不同接口的响应信封、状态码或必填字段。

快速入口

接入准备

配置账户服务请求域名、apikey、x-timestamp 和出口 IP 白名单，开始调用账户余额、账户流水、账户账单与 Global Account 接口。