Billing
This section describes Billing webhooks, which are only applicable for API version 2025-06-16 and later.
subscription.*
JSON1{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.*
JSON1{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.*
JSON1{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.*
JSON1{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.*
JSON1{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
JSON1{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.*
JSON1{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
JSON1{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}