New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • eInvoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Site Configuration
  3. Articles and FAQ
  4. Events & Webhooks
  1. Billing
  2. Site Configuration
  3. Articles and FAQ
  4. Events & Webhooks

How would I know if the configured webhook URL in my Chargebee site is failing?

This article also covers

  • Does Chargebee retry sending the webhook notification in case of a failure?
  • Are the site users notified when a webhook fails?
  • How to configure the recipient of Webhook failure Alerts email notifications
  • Configure the recipient of Webhook failure Alerts email notifications

Solution

To mark a webhook notification successful, we expect the HTTP status code to be 200 from your webhook URL. If we don't receive a 200 response code, Chargebee automatically retries calling your webhook with the exponential time interval for next 3 days. You could also try resending it from our admin console. For the total number of retry refer here.

If all the retry attempts have failed, Chargebee sends a mail to the owner and all the admins of the particular Chargebee site, informing that the webhooks are failing.

You can Configure recipients for 'Webhook Failure Alerts' from Settings > Chargebee Notification > Webhook Failure Alerts > Manage

image

The email notification will ONLY be sent for webhook call failures in the LIVE site and will only be sent once in a 24-hour period (from the first webhook failure) regardless of the number of webhook calls that may have failed during that time.

For example, if the first webhook failure occurs at 10 AM on January 1st, then an email notification will be sent right away. However, no emails will be sent for any failures that may happen in the next 24 hours. The next email will only be sent if there are any failures after 10 AM on January 2nd.

Note: Chargebee Supports multiple API versions now. The api_version attribute indicates the API version based on which the event content is structured. While processing webhooks, ensure the api_version is the same as the API version used by your webhook server's client library.

Related Articles

Accepted SSL certificates
How to create events for subscriptions?
My test webhooks events are not getting delivered. What should I do?
Can I filter events for a specific customer using API?
How can I be notified of only certain events using webhooks?
How to download Event logs?
Webhooks - SSL Communication Error
TLS 1.2 Handshake - Testing Code
My SSL certificate is not supported?
I received a webhook failure email from Chargebee. How to fix this?
How do I find failed webhooks and resend them?
301 or 302 Redirection error for Webhooks URL
Delay in webhooks notifications
How to do bulk Webhook Re-submit?
How to test webhooks on staging which requires VPN?
At which rate can we expect the webhook calls in Chargebee & Will there be any performance disruption?
Unable to view Webhook Failures from the email received from Chargebee
Meaning of 'optional' in Webhook events

Show more

Was this article helpful?