Receive stablecoin payments to Global Accounts

Stablecoin payments are currently available via API only and are not supported in the Airwallex web app.

Sending stablecoins to an incorrect wallet address or unsupported network will result in the irreversible loss of funds. Always verify the wallet address and network before sending.

You can receive stablecoin payments (USDC on Ethereum network) into your Airwallex Wallet by creating a Global Account with a stablecoin wallet. Once created, your payer sends USDC to the on-chain address, and the funds settle into your Wallet.

Before you begin

Obtain your access tokenAPI by authenticating to Airwallex using your unique Client ID and API key.
Set up webhooks to receive notifications on payment events.
Contact your Airwallex Account Manager to enable stablecoin payments for your account. The following setup is managed by your Account Manager:
- Stablecoin infrastructure onboarding (via BVNK, Airwallex's stablecoin infrastructure partner that processes on-chain transactions)
- Stablecoin feature flag enablement
- AIRWALLEX_US entity configuration

Step 1: Create a Global Account with a stablecoin wallet

Call the Create a Global AccountAPI endpoint. Include a stablecoin_wallet object in required_features specifying the asset and network. When stablecoin_wallet is specified, transfer_method is optional.

Example request

Shell

1curl -X POST https://api-demo.airwallex.com/api/v1/global_accounts/create \
2  -H 'Content-Type: application/json' \
3  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
4  -d '{
5    "country_code": "US",
6    "nick_name": "USDC Receiving Account",
7    "request_id": "7f687fe6-dcf4-4462-92fa-80335301d9d2",
8    "required_features": [
9      {
10        "currency": "USD",
11        "stablecoin_wallet": {
12          "asset": "USDC",
13          "network": "ETHEREUM"
14        }
15      }
16    ]
17  }'

Example response

The response includes a stablecoin_address field at the root level — this is the on-chain address your payer will send USDC to.

Because stablecoin Global Accounts use on-chain wallet addresses instead of traditional bank accounts, fields like account_number and institution return placeholder values. The stablecoin_address field contains the address needed for receiving funds.

JSON

1{
2  "account_name": "Marks Group",
3  "account_number": "-",
4  "country_code": "US",
5  "id": "7f687fe6-dcf4-4462-92fa-80335301d9d2",
6  "institution": {
7    "address": "-",
8    "city": "-",
9    "name": "-"
10  },
11  "nick_name": "USDC Receiving Account",
12  "request_id": "8d411ad4-aed6-1261-92fa-51225212e2e1",
13  "required_features": [
14    {
15      "currency": "USD",
16      "stablecoin_wallet": {
17        "asset": "USDC",
18        "network": "ETHEREUM"
19      }
20    }
21  ],
22  "stablecoin_address": "0x9D6ce39727F2Cbe4C09f99c2C490E1b385103eD7",
23  "status": "ACTIVE",
24  "supported_features": [
25    {
26      "currency": "USD",
27      "stablecoin_wallet": {
28        "asset": "USDC",
29        "network": "ETHEREUM"
30      },
31      "type": "DEPOSIT"
32    }
33  ]
34}

Step 2: Send USDC to the receiving address

Share the stablecoin_address from the response with your payer. Your payer sends USDC on the Ethereum network to this address.

Once the on-chain transaction is confirmed, the payment will appear in your Airwallex account.

Step 3: Retrieve stablecoin payments

Call Get a list of depositsAPI to retrieve your payments. Stablecoin payments have:

type: STABLECOIN_TRANSFER
payer.stablecoin_wallet: contains the sender's asset, network, and address
reference: the on-chain transaction hash

Example request

Shell

1curl -G https://api-demo.airwallex.com/api/v1/deposits \
2  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
3  -d 'from_created_at=2025-04-01' \
4  -d 'to_created_at=2025-04-30'

Example response

JSON

1{
2  "has_more": false,
3  "items": [
4    {
5      "amount": 500.00,
6      "created_at": "2025-04-20T10:30:00+0000",
7      "currency": "USD",
8      "global_account_id": "fcfc369c-ce9d-4ab7-b9af-80df61848f8f",
9      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
10      "payer": {
11        "stablecoin_wallet": {
12          "asset": "USDC",
13          "network": "ETHEREUM",
14          "address": "0x9876543210fedcba9876543210fedcba98765432"
15        }
16      },
17      "reference": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
18      "settled_at": "2025-04-20T10:35:00+0000",
19      "status": "SETTLED",
20      "type": "STABLECOIN_TRANSFER"
21    }
22  ]
23}

Sandbox testing

Sandbox simulation for stablecoin deposits is not currently available. To test your integration end-to-end, contact your Airwallex Account Manager to set up a demo environment with stablecoin payments enabled.

Next steps

Was this page helpful?