# Overview

> Account balance, account transaction, account statement, and Global Account management services.

Onerway Account is for merchants that need to manage account funds, query balance movements, export statements, and use Global Account capabilities. You can use Account service APIs to query multi-currency balances, trace account transactions, export daily statements, and create or query a Global Account after the required capability is enabled.

<tip>

For new integrations with account balance, account transaction, and account statement APIs, use the current Account service endpoints. The API Reference sidebar groups the current endpoints by Account balance, Account transaction, Account statement, and Global Account. Deprecated endpoints are not shown as current integration entry points.

</tip>

## Capabilities

| Capability | Use case | Recommended entry point |
| --- | --- | --- |
| Account balance | Query balance summaries across currencies or read the balance for one currency. | [Query account balance overview](/account/api-reference/endpoints/query-account-balance-overview) |
| Account transaction | Query account balance movement records or look up related records by transaction order number. | [Query account transactions](/account/api-reference/endpoints/query-account-transactions) |
| Account statement | Export daily account statement CSV files for finance reconciliation. | [Export daily account statement](/account/api-reference/endpoints/export-daily-statement) |
| Global Account | Create a Global Account and retrieve onboarding details, account status, and notification URL. | [Create Global Account](/account/api-reference/endpoints/create-global-account) |
| Response codes | Identify causes from Account service response codes and decide troubleshooting actions. | [Response codes](/account/api-reference/response-codes) |

## Integration Path

<steps level="3">

### Complete setup

Prepare the Account service base URL, `apikey`, `x-timestamp`, outbound IP allowlist, and API permissions first. The current Account service base URLs are:

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

The [Setup](/account/get-started/setup) page includes required request headers, the example `apikey`, the 10-minute timestamp window, and the endpoint URL checklist.

### Query account balances

After setup, start with the balance APIs to verify account access and currency data.

- [Query account balance overview](/account/api-reference/endpoints/query-account-balance-overview): use for dashboards, fund summaries, and multi-currency balance views.
- [Query account balance](/account/api-reference/endpoints/query-account-balance): use before payments, payouts, or reconciliation when you need the balance for one currency.

### Query account transactions

Account transactions help explain balance changes and connect account movements with orders, payments, or payout records.

- [Query account transactions](/account/api-reference/endpoints/query-account-transactions): query records by currency, time range, and pagination.
- [Query account transactions by transaction order number](/account/api-reference/endpoints/query-account-transactions-by-service-id): use this when you already have a transaction order number and need the related account movements.

### Export account statements

For finance reconciliation or archival, use [Export daily account statement](/account/api-reference/endpoints/export-daily-statement) to download a CSV file for a specified date. Store files by business date and keep the request parameters with the exported file for later traceability.

### Use Global Account

For account opening, collection, or payout scenarios, confirm that the Global Account capability is enabled, then call:

- [Create Global Account](/account/api-reference/endpoints/create-global-account)
- [Get Global Account details](/account/api-reference/endpoints/get-global-account-details)

</steps>

## Field Differences

The current account balance, account transaction, and account statement APIs use the Account service response shape:

| Item | Current Account service endpoints |
| --- | --- |
| Authentication | `apikey` header |
| Replay protection header | `x-timestamp` |
| Success response code | `respCode = 20000` |
| Response message field | `respMsg` |
| Error object | `error` |
| Idempotency field | `requestId`, used for safe retry within 10 minutes |

Global Account APIs follow the field names shown on their current endpoint pages. Do not mix response envelopes, status codes, or required fields across different endpoints.

## Quick Links

- [Setup](/account/get-started/setup) - Prepare the Account service base URL, `apikey`, `x-timestamp`, and outbound IP allowlist
- [Query account balance overview](/account/api-reference/endpoints/query-account-balance-overview) - Query multi-currency account balance summaries
- [Query account transactions](/account/api-reference/endpoints/query-account-transactions) - Review account transaction records and balance movements
- [Export daily account statement](/account/api-reference/endpoints/export-daily-statement) - Export a daily account statement CSV
- [Create Global Account](/account/api-reference/endpoints/create-global-account) - Create a Global Account
- [Response codes](/account/api-reference/response-codes) - Handle Account service response codes and troubleshooting actions