Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewUnderstanding Global Treasury
Market & infrastructure coverage
Use cases
Get started
Set up your platform accountGlobal Accounts
Manage Global AccountsGlobal Accounts in regulated countries/regions
Linked Accounts
Hold & convert funds
Test and go live

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 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 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: Specify LOCAL or SWIFT depending on the region and currency.

    • Specifying LOCAL in your request will open a Global Account that supports only LOCAL, or both LOCAL and SWIFT payment methods.
    • Specifying SWIFT in your request will open a Global Account that supports only the SWIFT payment method.
    • See Supported regions and currencies to learn more about our supported payment methods.
  • 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 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 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 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.

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:

CurrencyIntermediary Bank NameIntermediary bank SWIFT CodeIntermediary Bank AddressIntermediary Bank CityIntermediary Bank ZIP Code
USDFirst National Banker’s BankFRNAUS447813 Office Park BlvdBaton Rouge, LA70809

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:

CurrencyCorrespondent Bank NameCorrespondent Bank SWIFT Code
USDStandard Chartered BankSCBLUS33
EURStandard Chartered BankSCBLDEFX
AUDAustralia and New Zealand Banking Group LimitedANZBAU3M
CADRoyal Bank of CanadaROYCCAT2
CHFCredit SuisseCRESCHZZ80A
GBPCredit Suisse (Schweiz) AGSCBLGB2L
JPYStandard Chartered BankSCBLJPJT
NZDASB Bank LimitedASBBNZ2A
SGDStandard Chartered Bank (Singapore) LimitedSCBLSG22

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:

CurrencyCorrespondent Bank NameCorrespondent Bank SWIFT Code
USDJP Morgan Chase BankCHASUS33
EURBarclays Bank Ireland PLCBARCDEFF
AUDCommonwealth Bank of AustraliaCTBAAU2S
CADToronto-Dominion BankTDOMCATTTOR
CHFUBS AGUBSWCHZH80A
GBPNational Westminster Bank PLCNWBKGB2L
JPYSumitomo Mitsui Banking CorporationSMBCJPJT
NZDASB Bank LimitedASBBNZ2A
SGDDBS Bank LtdDBSSSGSG

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:

CurrencyCorrespondent Bank NameCorrespondent Bank SWIFT CodeIntermediary Bank NameIntermediary Bank SWIFT Code
CHFUBS AGUBSWCHZH80ACitibank N.A.CITIGB2L
CZKCitibank Europe Plc.CITICZPXCitibank N.A.CITIGB2L
HUFCitibank Europe Plc.CITIHUHXCUSCitibank N.A.CITIGB2L
MXNBanco National De MexicoBNMXMXMMCVTCitibank N.A.CITIGB2L
NOKDen Norske BankDNBANOKKCitibank N.A.CITIGB2L
PLNBank HandlowyCITIPLPXCitibank N.A.CITIGB2L
RONCitibank RomaniaCITIROBUCitibank N.A.CITIGB2L
SEKSvenska HandelsbankenHANDSESSCitibank N.A.CITIGB2L
ZARCitibank N.A.CITIZAJXCitibank N.A.CITIGB2L
ILSCitibank N.A.CITIILITCitibank N.A.CITIGB2L
On this page
  • Before you begin
  • Create a Global Account
  • Retrieve details of your Global Account
  • Next steps