Airwallex logo

Receiving funds

Funds can be received from bank settlements into your platform wallet via the following actions:

  • Wallet top up
  • Global account deposit
  • Receiving funds from Airwallex ecosystem

Wallet top up

A wallet top up is executed by your business whereby funds are directed to the settlement account allocated to your Airwallex account. To get your settlement account details, use the Settlement accounts API and a response will be returned for each currency relevant to your platform account.

curl -X GET \  http://api-demo.airwallex.com/api/v1/global_accounts?currency=USD&country_code=HK&nick_name=Wishcom&page_num=0&page_size=10 \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIwZGE4YjVlMi0xZWNhLTRmN2EtODY4Ni1mNTYzOGUzZmFkZmQiLCJzdWIiOiIwZGZlMTgyNS05ODUxLTRjNDctOTNiMy1mMzViNTQzMDJiOTAiLCJpYXQiOjE1NDcwMDQyNjYsImV4cCI6MTU0NzAxNjI2Nn0.PPIM2Ve2VwCzPS2swa6L7JGzDC_i26Guls02YDzI668' \
-H 'Content-Type: application/json' \

Global account deposit

A global account deposit is executed by a payer to which you provide your global account details. You can open a global account and immediately receive your global account details using the Open a global account API.

https://api-demo.airwallex.com/api/v1/global_accounts/create \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNTI1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cahce' \
-d '{ 
  "country_code": "GP", 
  "currency": "GBP", 
  "nick_name": "GBP Account in UK for Subsidiary Company ABC", 
  "payment_methods": [ "LOCAL" ], 
  "request_id": "7f687fe6-dcf4-4462-92fa-80335301d9d2" 
}'

Funds can also be deposited to a connected account via the above mentioned actions. To create a global account on behalf of your counterparty, you can use the on_behalf_of header along with the Open a global account API.

curl -X POST \
http://api-demo.airwallex.com/api/v1/global_accounts/create \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIwZGE4YjVlMi0xZWNhLTRmN2EtODY4Ni1mNTYzOGUzZmFkZmQiLCJzdWIiOiIwZGZlMTgyNS05ODUxLTRjNDctOTNiMy1mMzViNTQzMDJiOTAiLCJpYXQiOjE1NDcwMDQyNjYsImV4cCI6MTU0NzAxNjI2Nn0.PPIM2Ve2VwCzPS2swa6L7JGzDC_i26Guls02YDzI668' \
-H 'x-on-behalf-of: 133097196' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
"account_name": "Airwallex",
"country_code": "GP",
"currency": "GBP",
"nick_name": "GBP in UK for Subsidiary Company ABC",
"open_id": "189109846",
"payment_methods": ["LOCAL"],
"request_id": "7f687fe6-dcf4-4462-92fa-80335301d9d2"
}'

Any deposits to a global account will immediately reflect in the wallet upon settlement.

As designated accounts for users with local and global collections needs, global accounts support both domestic and global collections via local clearing systems and SWIFT. Domestic collections enable platforms and their counterparties to establish a local presence in their target markets, allowing them to collect local currencies (or other currencies supported by the domestic clearing system) in that particular jurisdiction. Global collections allow platforms to receive proceeds globally in supported currencies via SWIFT, giving it the maximum flexibility over funds collection in supported currencies regardless of its physical presence.

GLOBAL ACCOUNT DOMICILECOLLECTION TYPESUPPORTED CURRENCIESPAYMENT TYPES ACCEPTED
United StatesLocalUSDNacha, IAT
United KingdomLocalGBPFast Payments, BACS, CHAPS
GermanyLocalEURSEPA
Hong KongLocalUSD, HKD, CNH, EURCNH, HKD - CHATS, Faster Payments System EUR, USD - RTGS
Hong KongSWIFTUSD, HKD, CNH, EUR, JPY, AUD, CHF, CAD, GBP, SGD, NZDSWIFT
AustraliaLocalAUDBECS

Receiving funds from Airwallex ecosystem

Funds originating within the Airwallex ecosystem can be received into your platform wallet via the following actions:

  • Charges
  • Wallet transfers executed on behalf of a connected account.

As a platform, you can access deposit information for your own account using the Get list of deposits API. The same API can be used to view wallet deposits for a connected account in line with authorisation levels by using the on behalf of tag.