Airwallex logo
Airwallex logo
Home
Developer Tools
Developer Tools
Back to home
OverviewAPI
SDKs
Sandbox environment
Webhooks
Listen for webhook events
Event types
Payload examples
AccountBalanceBilling
ChargesConnected Account TransfersConnectionsConversionsDepositsDirect debit payoutsGlobal AccountsIssuingLinked AccountsOnline PaymentsPlatformRFITaxTransfers
Code examples
Test webhook event payloadsView webhook eventsRe-trigger webhook events

Billing

This section describes Billing webhooks, which are only applicable for API version 2025-06-16 and later.

subscription.*

JSON
1{
2 "id": "790fb1e1-01e6-41d5-a821-297d51b43599",
3 "name": "subscription.created",
4 "account_id": "acct__ncI2nypPKSq2VXKxscAcg",
5 "created_at": "2022-08-02T03:07:55+0000",
6 "data":Object{...}
7}

data is the response body from Retrieve a Subscription API of the corresponding API version you subscribe to.

invoice.*

JSON
1{
2 "id":"9c830876-5290-4a46-b3b0-aa3c6d8e8b50",
3 "name":"invoice.created",
4 "account_id":"acct__ncI2nypPKSq2VXKxscAcg",
5 "created_at": "2022-08-02T03:07:55+0000",
6 "data":Object{...}
7}

data is the response body from Retrieve an Invoice API of the corresponding API version you subscribe to.

billing_transaction.*

JSON
1{
2 "id":"9c830876-5290-4a46-b3b0-aa3c6d8e8b50",
3 "name":"billing_transaction.created",
4 "account_id":"78814faa-1b30-4598-a9c8-f0583db8d09d",
5 "created_at": "2022-08-02T03:07:55+0000",
6 "data":Object{...}
7}

data is the response body from Retrieve a Billing Transaction API of the corresponding API version you subscribe to.

billing_checkout.*

JSON
1{
2 "id":"2a396f97-92f4-3075-98fa-43acf6e87412",
3 "name":"billing_checkout.created",
4 "account_id":"78814faa-1b30-4598-a9c8-f0583db8d09d",
5 "created_at": "2025-07-30T07:39:43+0000",
6 "data":Object{...}
7}

data is the response body from Retrieve a Billing Checkout API of the corresponding API version you subscribe to.

This section describes the Billing webhook, which are only applicable for API version 2025-04-25 and before.

subscription.*

JSON
1{
2 "id": "790fb1e1-01e6-41d5-a821-297d51b43599",
3 "name": "subscription.created",
4 "source_id": "sub_hkstzqcl4gc7ma2ykn7",
5 "account_id": "78814faa-1b30-4598-a9c8-f0583db8d09d",
6 "created_at": "2022-08-02T03:07:55+0000",
7 "data":{
8 "object": {...}
9 }
10}

object is the response body from Retrieve a Subscription API

JSON
1{
2 "id": "sub_hkstzqcl4gc7ma2ykn7",
3 "status": "ACTIVE",
4 "customer_id": "cus_hkst2q96fgbzw4gdpyc",
5 "payment_consent_id": "cst_hkstp6spzgc7m9xic5y",
6 "latest_invoice_id": "inv_hkstc4dn8gc7ma30pq1",
7 "trial_start_at": null,
8 "trial_end_at": null,
9 "current_period_start_at": "2022-08-02T03:07:53+0000",
10 "current_period_end_at": "2022-09-02T03:07:53+0000",
11 "created_at": "2022-08-02T03:07:55+0000",
12 "updated_at": "2022-08-02T03:07:55+0000",
13 "cancel_at": "2023-08-02T03:07:53+0000",
14 "cancel_at_period_end": false,
15 "cancel_requested_at": null,
16 "next_billing_at": "2022-09-02T03:07:53+0000",
17 "remaining_billing_cycles": 11,
18 "total_billing_cycles": 12,
19 "recurring": {
20 "period": 1,
21 "period_unit": "MONTH"
22 },
23 "metadata": {}
24}

invoice.*

JSON
1{
2 "id":"9c830876-5290-4a46-b3b0-aa3c6d8e8b50",
3 "name":"invoice.sent",
4 "source_id": "inv_hkstc4dn8gc7ma30pq1",
5 "account_id":"78814faa-1b30-4598-a9c8-f0583db8d09d",
6 "created_at": "2022-08-02T03:07:55+0000",
7 "data":{
8 "object": {...}
9 }
10}

object is the response body from Retrieve an Invoice API

JSON
1{
2 "id": "inv_hkstc4dn8gc7ma30pq1",
3 "customer_id": "cus_hkst2q96fgbzw4gdpyc",
4 "status": "SENT",
5 "currency": "USD",
6 "total_amount": 5,
7 "subscription_id": "sub_hkstzqcl4gc7ma2ykn7",
8 "payment_intent_id": "int_hkstp6spzgc7ma34l23",
9 "period_start_at": "2022-08-02T03:07:53+0000",
10 "period_end_at": "2022-09-02T03:07:53+0000",
11 "past_payment_attempt_count": 0,
12 "created_at": "2022-08-02T03:07:53+0000",
13 "updated_at": "2022-08-02T03:07:55+0000"
14}
Was this page helpful?