Airwallex logo
Airwallex logoAirwallex logo

Balance

Subscribe to webhook events for wallet balance changes.

Copy for LLMView as Markdown

The following webhook events are available for your Accounts integration.

EventDescription
balance.va.top_upWallet balance increase due to deposit received via Virtual Account.
balance.ga.top_upWallet balance increase due to deposit received via Global Account.
balance.adjustmentBalance change due to adjustment.

Payload examples

balance.va.top_up

JSON
1{
2 "accountId":"acct__a5wGZOZPiauZ8SO6V3zWA",
3 "data":{
4 "amount":50000,
5 "balance":76774.68,
6 "ccy":"CNY",
7 "createdAt":"2019-06-19T06:14:18+0000",
8 "transactionReference":{
9 "depositId":"05e72d9d-8cd9-4a38-9c62-060cb10deb81"
10 },
11 "type":"DEPOSIT"
12 },
13 "id":"6594277f-bcca-3968-9d71-27baf1abd489",
14 "name":"balance.va.top_up"
15}

balance.ga.top_up

JSON
1{
2 "accountId": "acct_qKW8Sq-8MhW399a49QUb8Q",
3 "data": {
4 "amount": 567,
5 "balance": 567,
6 "ccy": "EUR",
7 "createdAt": "2019-06-18T12:15:25+0000",
8 "reference": "9617011793",
9 "transactionReference": {
10 "depositId": "26a00894-fb13-4b08-8eb4-af695651d8cf",
11 "globalAccountId": "f88813b4-1b04-4869-9801-bdc804eb4507",
12 "transactionId": "4dc1aff5-cc7f-4cfa-a3be-1e6fc338efc4",
13 "payerName": "John Smith",
14 "payerBankName": "ABC Bank"
15 },
16 "type": "DEPOSIT"
17 },
18 "id": "56ab96c2-324e-3da5-858b-61f2e316fac2",
19 "name": "balance.ga.top_up"
20}

balance.adjustment

JSON
1{
2 "accountId":"acct__a5wGZOZPiauZ8SO6V3zWA",
3 "data":{
4 "amount":50000,
5 "balance":126774.68,
6 "ccy":"CNY",
7 "createdAt":"2019-06-19T06:14:58+0000",
8 "transactionReference":{
9 "adjustmentId":"f0728610-9ac7-431b-b9b6-5d6ed710373b",
10 "reason":"[Refund] some reason details"
11 },
12 "type":"ADJUSTMENT"
13 },
14 "id":"33619f4c-2cde-3767-8d65-7b3557924943",
15 "name":"balance.adjustment"
16}
Was this page helpful?