Airwallex logo

Creating accounts

Creating accounts

Create Airwallex accounts for your merchants, business partners, subsidiaries and clients via the Accounts API. The connected account that you create via the Accounts API will be linked to your platform account and you will have authorization to transact on behalf of the connected account using Airwallex's Scale APIs.

You can create a new connected account instantly by submitting three pieces of basic information: primary contact email address, confirmation of agreement to Airwallex's terms and conditions, and business name. The new account will subsequently be connected to your own account.

By confirming agreement to Airwallex's terms and conditions, you consent to the terms covering the tri-party relationship between Airwallex, your business and the counterparty on whose behalf you are opening the account, and in doing so, Airwallex is authorised to take action on the connected account according to your instructions.

curl -X POST \
    http://api-demo.airwallex.com/api/v1/accounts/create \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIwZGE4YjVlMi0xZWNhLTRmN2EtODY4Ni1mNTYzOGUzZmFkZmQiLCJzdWIiOiIwZGZlMTgyNS05ODUxLTRjNDctOTNiMy1mMzViNTQzMDJiOTAiLCJpYXQiOjE1NDcwMDQyNjYsImV4cCI6MTU0NzAxNjI2Nn0.PPIM2Ve2VwCzPS2swa6L7JGzDC_i26Guls02YDzI668' \
    -H 'Content-Type: application/json' \
    -d '{
      "account_details": {
        "business_details": {
      	    "business_name":"your_business_name"
      	}
      },
      "customer_agreements": {
        "agreed_to_data_usage": true,
        "agreed_to_terms_and_conditions": true
      },
      "primary_contact": {
        "email": "[email protected]"
      }
    }

The response includes the Airwallex account ID pertaining to the connected account, which you will use in the next steps.

By providing the account ID in the Update a connected account API, you can amend and submit account information along with the file IDs related to any supporting documents that you submit via the File Service API.

curl -X POST \
http://api-demo.airwallex.com/api/v1/accounts/160748422/update \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIwZGE4YjVlMi0xZWNhLTRmN2EtODY4Ni1mNTYzOGUzZmFkZmQiLCJzdWIiOiIwZGZlMTgyNS05ODUxLTRjNDctOTNiMy1mMzViNTQzMDJiOTAiLCJpYXQiOjE1NDcwMDQyNjYsImV4cCI6MTU0NzAxNjI2Nn0.PPIM2Ve2VwCzPS2swa6L7JGzDC_i26Guls02YDzI668' \
-H 'Content-Type: application/json' \
-d '{
"account_details":{
	"business_details": {
	    "address": {
	        "address_line1": "200 Collins Street",
	        "address_line2": "200 Collins Street",
	        "postcode": "1111",
	        "country_code":"HK",
	        "state": "HK",
	        "suburb": "HK"
	    },
	    "attachments": {
            "business_documents": [
                {
                    "description": "description about your Registration certificate file",
                    "file_id": "NWRiYjUzMTItNWY2MC00MDNiLWE4ZmUtOTllYjRjZGZhZmU4LHwsc2hlbnpoZW4sfCw0LjLvvIlHTFDkuJrliqHpnIDmsYIgJiBBV1jlr7nmjqXmlrnmoYggMTIuMjAueGxzeA==",
                    "tag": "REGISTRATION_CERTIFICATE"
                },
                {
                	"description": "description about your Certificate of Incorporation file",
                    "file_id": "NWRiYjUzMTItNWY2MC00MDNiLWE4ZmUtOTllYjRjZGZhZmU4LHwsc2hlbnpoZW4sfCxEb2MxICgxKS5kb2N4",
                    "tag": "CERTIFICATE_OF_INCORPORATION"
                },
                {
                	"description": "description about your Annual report file",
                    "file_id": "NWRiYjUzMTItNWY2MC00MDNiLWE4ZmUtOTllYjRjZGZhZmU4LHwsc2hlbnpoZW4sfCwtLnR4dF8xNTQ2NTk1NTY1",
                    "tag": "ANNUAL_REPORT"
                }
            ]
        }
	},
	"legal_rep_details":{
        "attachments": {
            "identity_files": [
            	{
                    "description": "nation_id front",
                    "file_id": "NWRiYjUzMTItNWY2MC00MDNiLWE4ZmUtOTllYjRjZGZhZmU4LHwsc2hlbnpoZW4sfCwtLnR4dF8xNTQ2NTk1NTgw",
                    "tag": "NATIONAL_ID_FRONT"
                },
                {
                    "description": "nation_id back",
                    "file_id": "NWRiYjUzMTItNWY2MC00MDNiLWE4ZmUtOTllYjRjZGZhZmU4LHwsc2hlbnpoZW4sfCwtLnR4dF8xNTQ2NTk1NTkx",
                    "tag": "NATIONAL_ID_BACK"
                }
                 
                ]
        },
        "nationality":"HK”
   		 }
 	}

Upon provision of all required information and documentation, you can submit the connected account for verification using our Submit account for activation API.

curl -X POST \
http://api-demo.airwallex.com/api/v1/accounts/160748422/submit \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIwZGE4YjVlMi0xZWNhLTRmN2EtODY4Ni1mNTYzOGUzZmFkZmQiLCJzdWIiOiIwZGZlMTgyNS05ODUxLTRjNDctOTNiMy1mMzViNTQzMDJiOTAiLCJpYXQiOjE1NDcwMDQyNjYsImV4cCI6MTU0NzAxNjI2Nn0.PPIM2Ve2VwCzPS2swa6L7JGzDC_i26Guls02YDzI668' \

Airwallex will return a response containing full account information and will indicate any missing or invalid fields as appropriate.