--- page_title: Webhooks - Billing product: Juspay Billing page_source: https://juspay.io/in/docs/juspay-billing/docs/billing/webhooks-billing llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/juspay-billing/llms.txt --- # Webhooks - Billing Webhooks are the backbone of a real-time billing system, allowing your application to automatically react to subscription lifecycle events—like successful payments, failed renewals, or cancellations—without the inefficiency of constant manual polling.Note - You will still continue to receive Mandate and Payment related webhooks also in addition to the Billing related webhooks. > **Note** > Merchants will continue to receive the existing webhooks for Orders, Transactions, and Mandates. In addition, they will now also receive new webhook events related to Billing. ### **Billing related events** | Event Name | Event Value | Event Description | |---|---|---| | BILLING_EXECUTION_CREATED | BILLING | Billing execution id Creation webhook | | BILLING_EXECUTION_ACTIVATED | BILLING | Billing execution id Activation webhook | | BILLING_EXECUTION_DEACTIVATED | BILLING | Billing execution id Deactivation webhook | | BILLING_EXECUTION_CREDIT_EVENT | BILLING | Any Credit event against a Billing execution id | | BILLING_EXECUTION_DEBIT_EVENT | BILLING | Any Debit event against a Billing execution id | | BILLING_EXECUTION_AMOUNT_BREACHED_LIMIT | BILLING | On breaching a fixed amount set by merchant in Usage based billing cases | | BILLING_TXN_SCHEDULED | BILLING | Scheduling of a transaction for a debit | | BILLING_RETRY_TXN_SCHEDULED | BILLING | Scheduling of a order that was supposed to be completely retried from Juspays end ( inlcuding notification if applicable) | | BILLING_TXN_TO_BE_EXECUTED | BILLING | 2 days before Billing transaction that was supposed to be executed | | BILLING_TXN_RETRY_EXCEEDED | BILLING | In case the billing txn retry has exceeded the number of retries | ## Sample Code Snippets: ### Billing Webhooks samples: #### BILLING_EXECUTION_CREATED Code Snippet: ```billing_execution_created { "id": "evt_V2_3ac94eebb4574464ac1d1504578f901e", "date_created": "2026-02-06T11:47:36Z", "content": { "source_object_id": "856", "status": "CREATED", "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source": "MANDATE", "merchant_id": "azharamin", "amount": 1, "customer_id": "cth_rPj21roNSjEbumSy" }, "event_name": "BILLING_EXECUTION_ACTIVATED" } ``` #### BILLING_EXECUTION_ACTIVATED Code Snippet: ```billing_execution_activated { "id": "evt_V2_3ac94eebb4574464ac1d1504578f901e", "date_created": "2026-02-06T11:47:36Z", "content": { "source_object_id": "856", "status": "ACTIVE", "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source": "MANDATE", "merchant_id": "azharamin", "amount": 1, "customer_id": "cth_rPj21roNSjEbumSy" }, "event_name": "BILLING_EXECUTION_ACTIVATED" } ``` #### BILLING_EXECUTION_DEACTIVATED Code Snippet: ```billing_execution_deactivated { "id": "evt_V2_3ac94eebb4574464ac1d1504578f901e", "date_created": "2026-02-06T11:47:36Z", "content": { "source_object_id": "856", "status": "INACTIVE", "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source": "MANDATE", "merchant_id": "azharamin", "amount": 1, "customer_id": "cth_rPj21roNSjEbumSy" }, "event_name": "BILLING_EXECUTION_DEACTIVATED" } ``` #### BILLING_EXECUTION_CREDIT_EVENT Code Snippet: ```billing_execution_credit_event { "id": "evt_V2_64f35b7b16244f18b92090206af7adfd", "date_created": "2026-02-06T11:47:36Z", "content": { "event": { "transaction_type": "CREDIT", "amount": 1, "event_id": "1770378188" }, "source_object_id": "856", "status": "ACTIVE", "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source": "MANDATE", "merchant_id": "azharamin", "amount": 1, "customer_id": "cth_rPj21roNSjEbumSy" }, "event_name": "BILLING_EXECUTION_CREDIT_EVENT" } ``` #### BILLING_EXECUTION_DEBIT_EVENT Code Snippet: ```billing_execution_debit_event { "id": "evt_V2_64f35b7b16244f18b92090206af7adfd", "date_created": "2026-02-06T11:47:36Z", "content": { "event": { "transaction_type": "DEBIT", "amount": 1, "event_id": "1770378188" }, "source_object_id": "856", "status": "ACTIVE", "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source": "MANDATE", "merchant_id": "azharamin", "amount": 1, "customer_id": "cth_rPj21roNSjEbumSy" }, "event_name": "BILLING_EXECUTION_DEBIT_EVENT" } ``` #### BILLING_EXECUTION_AMOUNT_BREACHED_LIMIT Code Snippet: ```billing_execution_amount_breached_limit { "id": "evt_V2_64f35b7b16244f18b92090206af7adfd", "date_created": "2026-02-06T11:47:36Z", "content": { "event": { "transaction_type": "DEBIT", "amount": 1, "event_id": "1770378188" }, "source_object_id": "856", "status": "ACTIVE", "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source": "MANDATE", "merchant_id": "azharamin", "amount": 1, "customer_id": "cth_rPj21roNSjEbumSy" }, "event_name": "BILLING_EXECUTION_AMOUNT_BREACHED_LIMIT" } ``` #### BILLING_TXN_SCHEDULED Code Snippet: ```billing_txn_scheduled { "id": "evt_V2_05a2ae9b74814c4f96d86152f64f7b20", "date_created": "2026-02-06T11:47:37Z", "content": { "exec_order_id": "vGmC5RBmkodwPbmt", "mandate": { "gateway": "EASEBUZZ", "mandate_id": "9ecFoX8LjCTPzA7GzD8UQS", "status": "ACTIVE", "frequency": "ASPRESENTED", "last_updated": "2026-02-06T11:47:37Z", "start_date": "1770378309", "max_amount": 30, "block_fund": false, "currency": "INR", "payment_info": { "payment_method": "UPI_COLLECT", "upi": { "payer_vpa": "authorise@upi" }, "payment_method_type": "UPI" }, "last_activated_at": "2026-02-06T11:47:37Z", "umrn": "e55aa89878@upi", "amount_rule": "VARIABLE", "gateway_reference_id": "upi", "revokable_by_customer": true, "order_id": "1770378188", "end_date": "1896608709", "billing_execution_info": { "source_object_id": "856", "status": "ACTIVE", "plan_info": { "plan_rule_value": 2, "plan_type": "PRE_DEBIT", "plan_model": "FIXED", "plan_introductory_cycles": null, "plan_status": "ACTIVE", "plan_amount": 7, "plan_created_at": "2026-02-06 12:06:19", "plan_currency": "INR", "plan_interval": "WEEKLY", "plan_rule_type": "AFTER", "plan_name": "test plan for local testing", "metric_info": null, "plan_description": "Fixed plan model + fixed amt", "plan_updated_at": "2026-02-06 12:06:19", "plan_trial_period_days": null, "plan_introductory_amount": null, "plan_id": "test01", "plan_action_on_failure": "REVOKE" }, "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source_object": "MANDATE", "amount": 1 }, "mandate_debit_token": "tkn_c66d53e5dbe4434eb82c83739b1dd3e5", "customer_id": "cth_rPj21roNSjEbumSy", "activated_at": "2026-02-06T11:47:37Z", "mandate_token": "610a7d34e6bc42d883a9f47a1d58521e", "mandate_type": "EMANDATE" } }, "event_name": "BILLING_TXN_SCHEDULED" } ``` #### BILLING_RETRY_TXN_SCHEDULED Code Snippet: ```billing_retry_txn_scheduled { "id": "evt_V2_05a2ae9b74814c4f96d86152f64f7b20", "date_created": "2026-02-06T11:47:37Z", "content": { "exec_order_id": "vGmC5RBmkodwPbmt", // New order ID "mandate": { "gateway": "EASEBUZZ", "mandate_id": "9ecFoX8LjCTPzA7GzD8UQS", "status": "ACTIVE", "frequency": "ASPRESENTED", "last_updated": "2026-02-06T11:47:37Z", "start_date": "1770378309", "max_amount": 30, "block_fund": false, "currency": "INR", "payment_info": { "payment_method": "UPI_COLLECT", "upi": { "payer_vpa": "authorise@upi" }, "payment_method_type": "UPI" }, "last_activated_at": "2026-02-06T11:47:37Z", "umrn": "e55aa89878@upi", "amount_rule": "VARIABLE", "gateway_reference_id": "upi", "revokable_by_customer": true, "order_id": "1770378188", "end_date": "1896608709", "billing_execution_info": { "source_object_id": "856", "status": "ACTIVE", "plan_info": { "plan_rule_value": 2, "plan_type": "PRE_DEBIT", "plan_model": "FIXED", "plan_introductory_cycles": null, "plan_status": "ACTIVE", "plan_amount": 7, "plan_created_at": "2026-02-06 12:06:19", "plan_currency": "INR", "plan_interval": "WEEKLY", "plan_rule_type": "AFTER", "plan_name": "test plan for local testing", "metric_info": null, "plan_description": "Fixed plan model + fixed amt", "plan_updated_at": "2026-02-06 12:06:19", "plan_trial_period_days": null, "plan_introductory_amount": null, "plan_id": "test01", "plan_action_on_failure": "REVOKE" }, "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source_object": "MANDATE", "amount": 1 }, "mandate_debit_token": "tkn_c66d53e5dbe4434eb82c83739b1dd3e5", "customer_id": "cth_rPj21roNSjEbumSy", "activated_at": "2026-02-06T11:47:37Z", "mandate_token": "610a7d34e6bc42d883a9f47a1d58521e", "mandate_type": "EMANDATE" } }, "event_name": "BILLING_RETRY_TXN_SCHEDULED" } ``` #### BILLING_TXN_TO_BE_EXECUTED Code Snippet: ```billing_txn_to_be_executed { "id": "evt_V2_05a2ae9b74814c4f96d86152f64f7b20", "date_created": "2026-02-06T11:47:37Z", "content": { "exec_order_id": "vGmC5RBmkodwPbmt", "mandate": { "gateway": "EASEBUZZ", "mandate_id": "9ecFoX8LjCTPzA7GzD8UQS", "status": "ACTIVE", "frequency": "ASPRESENTED", "last_updated": "2026-02-06T11:47:37Z", "start_date": "1770378309", "max_amount": 30, "block_fund": false, "currency": "INR", "payment_info": { "payment_method": "UPI_COLLECT", "upi": { "payer_vpa": "authorise@upi" }, "payment_method_type": "UPI" }, "last_activated_at": "2026-02-06T11:47:37Z", "umrn": "e55aa89878@upi", "amount_rule": "VARIABLE", "gateway_reference_id": "upi", "revokable_by_customer": true, "order_id": "1770378188", "end_date": "1896608709", "billing_execution_info": { "source_object_id": "856", "status": "ACTIVE", "plan_info": { "plan_rule_value": 2, "plan_type": "PRE_DEBIT", "plan_model": "FIXED", "plan_introductory_cycles": null, "plan_status": "ACTIVE", "plan_amount": 7, "plan_created_at": "2026-02-06 12:06:19", "plan_currency": "INR", "plan_interval": "WEEKLY", "plan_rule_type": "AFTER", "plan_name": "test plan for local testing", "metric_info": null, "plan_description": "Fixed plan model + fixed amt", "plan_updated_at": "2026-02-06 12:06:19", "plan_trial_period_days": null, "plan_introductory_amount": null, "plan_id": "test01", "plan_action_on_failure": "REVOKE" }, "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source_object": "MANDATE", "amount": 1 }, "mandate_debit_token": "tkn_c66d53e5dbe4434eb82c83739b1dd3e5", "customer_id": "cth_rPj21roNSjEbumSy", "activated_at": "2026-02-06T11:47:37Z", "mandate_token": "610a7d34e6bc42d883a9f47a1d58521e", "mandate_type": "EMANDATE" } }, "event_name": "BILLING_TXN_TO_BE_EXECUTED" } ``` #### BILLING_TXN_RETRY_EXCEEDED Code Snippet: ```billing_txn_retry_exceeded { "id": "evt_V2_05a2ae9b74814c4f96d86152f64f7b20", "date_created": "2026-02-06T11:47:37Z", "content": { "exec_order_id": "vGmC5RBmkodwPbmt", "mandate": { "gateway": "EASEBUZZ", "mandate_id": "9ecFoX8LjCTPzA7GzD8UQS", "status": "ACTIVE", "frequency": "ASPRESENTED", "last_updated": "2026-02-06T11:47:37Z", "start_date": "1770378309", "max_amount": 30, "block_fund": false, "currency": "INR", "payment_info": { "payment_method": "UPI_COLLECT", "upi": { "payer_vpa": "authorise@upi" }, "payment_method_type": "UPI" }, "last_activated_at": "2026-02-06T11:47:37Z", "umrn": "e55aa89878@upi", "amount_rule": "VARIABLE", "gateway_reference_id": "upi", "revokable_by_customer": true, "order_id": "1770378188", "end_date": "1896608709", "billing_execution_info": { "source_object_id": "856", "status": "ACTIVE", "plan_info": { "plan_rule_value": 2, "plan_type": "PRE_DEBIT", "plan_model": "FIXED", "plan_introductory_cycles": null, "plan_status": "ACTIVE", "plan_amount": 7, "plan_created_at": "2026-02-06 12:06:19", "plan_currency": "INR", "plan_interval": "WEEKLY", "plan_rule_type": "AFTER", "plan_name": "test plan for local testing", "metric_info": null, "plan_description": "Fixed plan model + fixed amt", "plan_updated_at": "2026-02-06 12:06:19", "plan_trial_period_days": null, "plan_introductory_amount": null, "plan_id": "test01", "plan_action_on_failure": "REVOKE" }, "billing_execution_info_id": "3e6560a9dff14ab3a3e16bd5972b595d", "source_object": "MANDATE", "amount": 1 }, "mandate_debit_token": "tkn_c66d53e5dbe4434eb82c83739b1dd3e5", "customer_id": "cth_rPj21roNSjEbumSy", "activated_at": "2026-02-06T11:47:37Z", "mandate_token": "610a7d34e6bc42d883a9f47a1d58521e", "mandate_type": "EMANDATE" } }, "event_name": "BILLING_TXN_RETRY_EXCEEDED" } ``` --- ## See Also - [Billing execution ids against customer id](https://juspay.io/in/docs/juspay-billing/docs/billing/billing-execution-ids-against-customer-id) - [Attach Add On](https://juspay.io/in/docs/juspay-billing/docs/billing/attach-add-on)