chargebee-webhooks

Verify Chargebee webhooks with Basic Auth in Node.js and Python backends.

79|11|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/hookdeck/webhook-skills --skill chargebee-webhooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chargebee-webhooks
Source: https://github.com/hookdeck/webhook-skills/tree/main/skills/chargebee-webhooks
Command: npx skills add https://github.com/hookdeck/webhook-skills --skill chargebee-webhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables secure receipt of Chargebee webhooks with Basic Auth verification to prevent unauthorized deliveries, simplifying event-driven backends.

Core Features & Use Cases

  • Webhook verification: Validate incoming Chargebee events using credentials defined in environment variables.
  • Event coverage: Demonstrates handling common events such as subscription_created, subscription_changed, subscription_cancelled, payment_succeeded, payment_failed, invoice_generated, and customer_created.
  • Cross-framework examples: Includes Express, Next.js, and FastAPI implementations to accelerate integration.

Quick Start

Run a webhook endpoint at /webhooks/chargebee, configure Chargebee to point to it, set CHARGEBEE_WEBHOOK_USERNAME and CHARGEBEE_WEBHOOK_PASSWORD in your environment, and start your server.

Frequently Asked Questions about chargebee-webhooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify Chargebee webhooks securely in FastAPI?

Handle Chargebee subscription events by routing webhooks to a dedicated endpoint that processes subscription_created, subscription_changed, subscription_cancelled, payment_succeeded, payment_failed, invoice_generated, and customer_created events after Basic Auth verification.

Can I use Basic Auth to receive Chargebee webhooks in Node.js?

Yes, you can receive Chargebee webhooks in Node.js using Express or Next.js by validating the Basic Auth Authorization header against your environment variables and returning HTTP 200 upon successful credential verification.

What environment variables do I need to set up for Chargebee webhook verification?

Set up Chargebee webhook verification by defining CHARGEBEE_WEBHOOK_USERNAME and CHARGEBEE_WEBHOOK_PASSWORD in your environment, which the server uses to validate the decoded Basic Auth credentials from incoming request headers.

Why does my Chargebee webhook endpoint return an error when missing Authorization headers?

The Chargebee webhook endpoint returns HTTP 200 on successful Basic Auth verification and handles missing or invalid Authorization header data by rejecting unauthorized deliveries, preventing unverified events from triggering subscription or payment actions.