Overview
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.
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 transaction | Query account balance movement records or look up related records by transaction order number. | Query account transactions |
| Account statement | Export daily account statement CSV files for finance reconciliation. | Export daily account statement |
| Global Account | Create a Global Account and retrieve onboarding details, account status, and notification URL. | Create Global Account |
| Response codes | Identify causes from Account service response codes and decide troubleshooting actions. | Response codes |
Integration Path
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 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: use for dashboards, fund summaries, and multi-currency balance views.
- 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: query records by currency, time range, and pagination.
- Query account transactions by transaction order number: 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 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:
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 - Prepare the Account service base URL,
apikey,x-timestamp, and outbound IP allowlist - Query account balance overview - Query multi-currency account balance summaries
- Query account transactions - Review account transaction records and balance movements
- Export daily account statement - Export a daily account statement CSV
- Create Global Account - Create a Global Account
- Response codes - Handle Account service response codes and troubleshooting actions