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 currencies and payments
Treasury Resources
Global Accounts
Manage Global Accounts
Review status codes
Linked Accounts
Getting Started

Manage Global Accounts

This page describes the various operations you can perform on Global Accounts once you create them.

Update your Global Account

After opening 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.

curl --request POST \
--url 'https://api-demo.airwallex.com/api/v1/global_accounts/update/<global_account_id>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <your_bearer_token>' \
--data '{ \
  "nick_name": "GBP in UK for Subsidiary Company ABC" \
}'

Retrieve Global Account transactions

You can obtain transaction details of funds received into 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, rather than all Wallet transactions, 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

curl --request GET \
--url 'https://api-demo.airwallex.com/api/v1/global_accounts/<global_account_id>/transactions?from_created_at=2017-04-01&page_num=0&page_size=100&to_created_at=2017-04-01T03%3A52%3A34%2B0000' \
--header 'Authorization: Bearer <your_bearer_token>'

Example response

{
  "has_more": false,
  "items": [
    {
      "amount": 10000,
      "create_time": "2017-03-22T16:08:02+1100",
      "currency": "AUD",
      "description": "string",
      "fee_amount": 10,
      "fee_currency": "AUD",
      "id": "90b98dc6-63a0-403f-816b-ac5305b42a11",
      "payer_country": "US",
      "payer_name": "AMZNnt70paD1",
      "status": "PENDING",
      "type": "CREDIT"
    }
  ]
}

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

curl --request POST \
--url 'https://api-demo.airwallex.com/api/v1/global_accounts/<global_account_id>/generate_statement_letter' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <your_bearer_token>' \
--data '{ \
  "account_statement_type": "AMAZON", \
  "registration_info": { \
    "agreement": true, \
    "registered_address": { \
      "address": "15 William Street", \
      "city": "Melbourne", \
      "country": "Australia", \
      "postcode": "3000", \
      "state": "VIC" \
    }, \
    "registered_email": "john.walker@gmail.com", \
    "registered_name": "John Walker" \
  } \
}
On this page
  • Update your Global Account
  • Retrieve Global Account transactions
  • Generate account statements