Log inGet started
Airwallex logo
Home
Online Payments
Treasury
Transactional FX
Payouts
Issuing
Scale
Open Banking
Developer Tools
API Reference
Home
Treasury
Overview
Introduction to TreasurySupported regions and currencies
Global Accounts
Get started with Global Accounts
Receive bank transfers to Global AccountsAuthorize direct debit payoutsManage Global AccountsGlobal Accounts in regulated countries/regions

Get started with Global Accounts

Global Accounts enable you to receive bank transfers into and authorize direct debit payouts from the Wallet. Learn how to create, manage and use Global Accounts in the region and currency of choice, as well as retrieve transaction details for the purposes of reconciliation, proof of funds, data analysis using Airwallex API API.

Before you begin

  • Obtain your access token API by authenticating to Airwallex using your unique Client ID and API key. You will need the access token to make API calls.
  • Set up webhooks to receive notifications on Global Account events.
  • If your business requires a large number of Global Accounts, please contact your Airwallex Account Manager.
  • As a Scale platform account, you can call all Global Accounts API endpoints on behalf of your connected accounts by specifying the connected account's open ID (in the format acct_xxxxxx) in the x-on-behalf-of header of your API request. To learn about how you can register as a platform and set up this solution, see our step-by-step guide on Scale integration.

Create a Global Account

Use the dynamic schema API to retrieve the supported currencies and payment methods for the country where the Global Account will be held. Based on this information, call the Open a Global Account API endpoint with the following parameters:

  • country_code: Specify the region where the Global Account will be held.
  • currency: Specify a currency that’s supported for the region provided.
  • nick_name: Specify a name to uniquely identify the Global Account. This is for your own record keeping only, and will not show up on bank statements.
  • payment_methods: Specify LOCAL or SWIFT depending on the region and currency.
  • request_id: Specify a unique identifier for the request.

The response will contain the bank account information of the Global Account including:

  • Global Account ID
  • Global Account details, account_name, account_number, account_type(CHECKING, SAVING, CURRENT)
  • Global Account status (ACTIVE)
  • Global Account capabilities including supported clearing_systems and payment_methods, as well as whether direct debit payouts are supported (support_direct_debit)
  • Global Account financial institution details, including bank name, branch name, bank address, routing code, and SWIFT code

Example request

Shell

If you are registered as a Scale platform account, you can call this endpoint on behalf of your connected accounts by specifying the open ID in the x-on-behalf-of header.

Example response

JSON

Retrieve details of your Global Account

Call Get Global Account by ID API by specifying Global Account ID in the endpoint URL.

Example request

Shell

If you are registered as a Scale platform account, you can call this endpoint on behalf of your connected accounts by specifying the open ID in the x-on-behalf-of header.

Example response

JSON

You can also retrieve all Global Accounts associated with your Airwallex account using Get a list of Global Accounts API. If you want to filter the results, provide additional parameters for time period (from_created_at, to_created_at), pagination (page_size,page_num), status, etc.

Example request

Shell

If you are registered as a Scale platform account, you can call this endpoint on behalf of your connected accounts by specifying the open ID in the x-on-behalf-of header.

Example response

JSON
On this page
  • Before you begin
  • Create a Global Account
  • Retrieve details of your Global Account
  • Next steps