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 platform, 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 thex-on-behalf-of
header of your API request. To learn about how you can register as a platform and set up this solution, see Global Treasury and Banking as a Service solutions.
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
: SpecifyLOCAL
orSWIFT
depending on the region and currency.- Specifying
LOCAL
in your request will open a Global Account that supports onlyLOCAL
, or bothLOCAL
andSWIFT
payment methods. - Specifying
SWIFT
in your request will open a Global Account that supports only theSWIFT
payment method. - See Supported regions and currencies to learn more about our supported payment methods.
- Specifying
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
,INACTIVE
) - Global Account capabilities including supported
clearing_systems
andpayment_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
If you are registered as a 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
Retrieve details of your Global Account
Call Get Global Account by ID API by specifying Global Account ID in the endpoint URL.
Example request
If you are registered as a 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
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.
Correspondent and Intermediary Banks for receiving deposits via SWIFT
Sometimes, banks sending funds into Airwallex Global Accounts via the SWIFT network may ask for information about a correspondent or intermediary bank in order to complete the transaction. Below are the correspondent or intermediary banks that can be provided to your payer’s bank.
To receive deposits via SWIFT for Global Accounts with ACH routing number ending in *6768
, intermediary bank information should always be provided to the payer’s bank:
Currency | Intermediary Bank Name | Intermediary bank SWIFT Code | Intermediary Bank Address | Intermediary Bank City | Intermediary Bank ZIP Code |
---|---|---|---|---|---|
USD | First National Banker’s Bank | FRNAUS44 | 7813 Office Park Blvd | Baton Rouge, LA | 70809 |
To receive deposits via SWIFT for Global Accounts with SWIFT code SCBLHKHH
, we recommend that the payer provides the following correspondent bank information to the payer’s bank:
Currency | Correspondent Bank Name | Correspondent Bank SWIFT Code |
---|---|---|
USD | Standard Chartered Bank | SCBLUS33 |
EUR | Standard Chartered Bank | SCBLDEFX |
AUD | Australia and New Zealand Banking Group Limited | ANZBAU3M |
CAD | Royal Bank of Canada | ROYCCAT2 |
CHF | Credit Suisse | CRESCHZZ80A |
GBP | Credit Suisse (Schweiz) AG | SCBLGB2L |
JPY | Standard Chartered Bank | SCBLJPJT |
NZD | ASB Bank Limited | ASBBNZ2A |
SGD | Standard Chartered Bank (Singapore) Limited | SCBLSG22 |
To receive deposits via SWIFT for Global Accounts with SWIFT code DHBKHKHH
, we recommend that the payer provides the following correspondent bank information to the payer’s bank:
Currency | Correspondent Bank Name | Correspondent Bank SWIFT Code |
---|---|---|
USD | JP Morgan Chase Bank | CHASUS33 |
EUR | Barclays Bank Ireland PLC | BARCDEFF |
AUD | Commonwealth Bank of Australia | CTBAAU2S |
CAD | Toronto-Dominion Bank | TDOMCATTTOR |
CHF | UBS AG | UBSWCHZH80A |
GBP | National Westminster Bank PLC | NWBKGB2L |
JPY | Sumitomo Mitsui Banking Corporation | SMBCJPJT |
NZD | ASB Bank Limited | ASBBNZ2A |
SGD | DBS Bank Ltd | DBSSSGSG |
To receive deposits via SWIFT for Global Accounts with SWIFT code SXPYDKKK
, we recommend that the payer provides the following correspondent and intermediary bank information to the payer’s bank:
Currency | Correspondent Bank Name | Correspondent Bank SWIFT Code | Intermediary Bank Name | Intermediary Bank SWIFT Code |
---|---|---|---|---|
CHF | UBS AG | UBSWCHZH80A | Citibank N.A. | CITIGB2L |
CZK | Citibank Europe Plc. | CITICZPX | Citibank N.A. | CITIGB2L |
HUF | Citibank Europe Plc. | CITIHUHXCUS | Citibank N.A. | CITIGB2L |
MXN | Banco National De Mexico | BNMXMXMMCVT | Citibank N.A. | CITIGB2L |
NOK | Den Norske Bank | DNBANOKK | Citibank N.A. | CITIGB2L |
PLN | Bank Handlowy | CITIPLPX | Citibank N.A. | CITIGB2L |
RON | Citibank Romania | CITIROBU | Citibank N.A. | CITIGB2L |
SEK | Svenska Handelsbanken | HANDSESS | Citibank N.A. | CITIGB2L |
ZAR | Citibank N.A. | CITIZAJX | Citibank N.A. | CITIGB2L |
ILS | Citibank N.A. | CITIILIT | Citibank N.A. | CITIGB2L |