# 概览

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

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

<tip>

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

</tip>

## 能力范围

| 能力 | 适用场景 | 推荐入口 |
| --- | --- | --- |
| 账户余额 | 查询账户各币种余额汇总，或读取指定币种余额明细。 | [查询账户余额总览](/zh/account/api-reference/endpoints/query-account-balance-overview) |
| 账户交易 | 查询账户余额变动流水，或按交易单号反查关联流水。 | [查询账户流水](/zh/account/api-reference/endpoints/query-account-transactions) |
| 账户账单 | 按日期导出账户账单 CSV，用于财务核对。 | [导出每日账户账单](/zh/account/api-reference/endpoints/export-daily-statement) |
| Global Account（全球收付账户） | 创建 Global Account，查询开户资料、账户状态和通知 URL。 | [创建 Global Account](/zh/account/api-reference/endpoints/create-global-account) |
| 响应码 | 根据账户服务响应码定位原因并决定排查动作。 | [响应码](/zh/account/api-reference/response-codes) |

## 接入路径

<steps level="3">

### 完成接入准备

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

| 环境 | Base URL |
| --- | --- |
| Sandbox | `https://sandbox-api.onerway.com/account-server` |
| Production | `https://api.onerway.com/account-server` |

[接入准备](/zh/account/get-started/setup) 页面包含完整请求 Header、示例 `apikey`、10分钟时间戳窗口和接口地址清单。

### 查询账户余额

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

- [查询账户余额总览](/zh/account/api-reference/endpoints/query-account-balance-overview)：适合首页看板、资金概览和多币种汇总。
- [查询账户余额](/zh/account/api-reference/endpoints/query-account-balance)：适合在支付、打款或对账前检查指定币种余额。

### 查询账户流水

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

- [查询账户流水](/zh/account/api-reference/endpoints/query-account-transactions)：按币种、时间范围和分页查询流水。
- [按交易单号查询账户流水](/zh/account/api-reference/endpoints/query-account-transactions-by-service-id)：当你已经知道交易单号时，用于反查关联的账户流水。

### 导出账户账单

财务对账或归档时，使用 [导出每日账户账单](/zh/account/api-reference/endpoints/export-daily-statement) 下载指定日期的 CSV 文件。建议按自然日归档，并保留请求参数与返回文件的对应关系，方便后续追溯。

### 使用 Global Account

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

- [创建 Global Account](/zh/account/api-reference/endpoints/create-global-account)
- [查询 Global Account 详情](/zh/account/api-reference/endpoints/get-global-account-details)

</steps>

## 接口字段差异

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

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

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

## 快速入口

- [接入准备](/zh/account/get-started/setup) - 准备账户服务 Base URL、`apikey`、`x-timestamp` 和出口 IP 白名单
- [查询账户余额总览](/zh/account/api-reference/endpoints/query-account-balance-overview) - 查询多币种账户余额汇总
- [查询账户流水](/zh/account/api-reference/endpoints/query-account-transactions) - 查询账户流水和余额变动记录
- [导出每日账户账单](/zh/account/api-reference/endpoints/export-daily-statement) - 导出指定日期的账户账单 CSV
- [创建 Global Account](/zh/account/api-reference/endpoints/create-global-account) - 创建 Global Account
- [响应码](/zh/account/api-reference/response-codes) - 处理账户服务响应码和排查动作