Chargebee

Chargebee manages subscription billing. Customers, subscriptions, plans, addons, invoices, transactions.

Data Model

• Customers are billing entities. Subscriptions link customer to plan. Status: active, cancelled, etc.
• Plans define pricing. Addons are optional extras. Invoices are generated from subscriptions.
• Coupons for discounts. Transactions are payment records. Items and Quotes for product catalog.
• id vs id_in_site: Some endpoints use id_in_site for customer-facing ids.

Gotchas

• Site name: Chargebee uses site subdomain. API URL: https://{site}.chargebee.com/api/v2.
• Subscription status: Check status before assuming active. Cancelled subscriptions may have end-of-term access.
• Attached items: Need item_id. Quote line groups need quote_id. Scheduled changes need subscription_id.