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 AccountsReceive bank transfers to Global AccountsAuthorize direct debit payoutsManage Global Accounts

Manage Global Accounts

You can perform the following operations on Global Accounts once you create them.

Update your Global Account

After creating a Global Account, you can only update the nick_name while other account details cannot be changed.

To update the nick_name, call Update existing Global Account API by specifying the Global Account ID.

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.

Retrieve Global Account transactions

You can obtain transaction details of funds received through your Global Account via bank transfers, and funds paid out via direct debit using Generate Global Account transactions API. The transactions retrieved are specific to the given Global Account, which could be useful for reconciliation purposes.

In your request, in addition to the mandatory Global Account id, you can specify the start date (from_created_at) and end date (to_created_at), and pagination settings (page_num, page_size) for the transaction report.

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

Generate account statements

As a Global Account holder, you may need to generate account statements as proof of account ownership to submit to a vendor, supplier, or auditor. This statement serves as a confirmation that you, as the Global Account holder, are a registered user of Airwallex payment services and have registered to receive payments via a specific Global Account.

Call Generate global account statement API by specifying the unique Global Account ID in the URL. Provide the following parameters in the request:

  • account_statement_type: You can generate two types of account statements:
    • GENERAL: Account statement for your Global Account in a specific currency and location.
    • AMAZON: Account statement specific to your seller account on Amazon marketplace. For this account statement, you must also provide registration_info and the registration_info.agreement field must be set to true.

A successful request will return the account statement as a PDF file.

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.

On this page
  • Update your Global Account
  • Retrieve Global Account transactions
  • Generate account statements