Chargebee
Connect a Chargebee site with a read-only API key so Checkbox reads your plans, trials and subscription events, and see what it can't read from Chargebee.
Checks only. Checkbox checks your pages, emails and cancellation flow, and reads your Chargebee plans and subscription events. Checkbox never changes anything in Chargebee. For a test subscription, use a generic test run. Reminders need time travel, which only Stripe test runs have.
Checkbox reads your plans and trials through the Chargebee API with a read-only key, and turns Chargebee webhooks (new subscriptions, trial-ending and renewal reminders, renewals, plan changes, cancellations) into lifecycle events. The reminder and cancellation checks use those events, and so do Notices.
Connect
- Register the site with
platform: "chargebee":
curl https://app.checkbox.site/v1/sites \
-u "$CHECKBOX_SECRET_KEY:" \
-H "Content-Type: application/json" \
-d '{ "url": "https://acme-saas.example", "platform": "chargebee" }'import Checkbox from '@checkbox-site/node';
const checkbox = new Checkbox(process.env.CHECKBOX_SECRET_KEY);
const site = await checkbox.sites.create({ url: 'https://acme-saas.example', platform: 'chargebee' });
console.log(site.id);import os
from checkbox import Checkbox
checkbox = Checkbox(os.environ["CHECKBOX_SECRET_KEY"])
site = checkbox.sites.create(url="https://acme-saas.example", platform="chargebee")
print(site["id"])- Create a read-only API key in Chargebee: Settings → Configure Chargebee → API Keys and Webhooks → API Keys → Add API Key → Read-Only Key. Choose All, or Restricted with both Product catalog and Transactional data checked. The direct link is
https://{your-site}.chargebee.com/apikeys_and_webhooks/api. Test and live sites have different keys: use the key of the site you want checked. - In the dashboard, open Site → Settings → Billing connection, choose Chargebee, and enter your site name (the
acmeofacme.chargebee.com) and the key. Checkbox reads your plans once to check the key, then stores it encrypted. With the API, callconnectBillingPlatformwith{ "platform": "chargebee", "credentials": { "site": "acme", "apiKey": "…" } }. - Add the webhook. Chargebee doesn't sign webhooks, so each site gets its own username and password. After you connect, the dashboard shows the webhook URL, username, password and events (they're also under Billing connection → Chargebee webhook, and in
webhook_setupin the API response). In Chargebee, open Settings → Configure Chargebee → API Keys and Webhooks → Webhooks → Add Webhook, paste the URL, turn on Protect webhook URL with basic authentication, enter the username and password, choose API version v2, and select the events (or keep All Events).
What Checkbox reads
| Setting | Read from Chargebee? |
|---|---|
| Plans: price, billing period, currency | Yes. Product Catalog 2.0 item prices or Product Catalog 1.0 plans, whichever your site uses. Tiered plans are read at their first-tier price |
| Free trials (length, and whether the trial cancels instead of converting) | Yes, from each plan |
| Fixed-term plans (a set number of billing cycles) | Yes |
| Subscription events: created, trial ending, renewal reminder, renewed, changed, cancelled, payment succeeded | Yes, through the webhook |
| Whether customers can cancel in the Chargebee portal | Only when a subscriber cancelled there in the last 30 days. Otherwise Not checked yet |
| Email notifications (trial-ending and renewal reminders) | No. Not checked yet until Checkbox sees the emails (BCC them, below) |
| Checkout terms and consent checkbox | No. Checkbox checks your checkout page in a real browser instead |
Checkbox never treats a setting it can't read as passing. It shows Not checked yet until it has evidence.
What to check
- Portal cancellation. In Settings → Configure Chargebee → Checkout & Self-Serve Portal → Portal, turn on Allow customers to cancel subscription, and link to the portal from your account page.
- Reminder emails. In Settings → Configure Chargebee → Email Notifications, turn on the trial-ending and renewal reminders and set the days so they fall inside the windows from
checkNoticeSchedule. Add your site's inbound address as BCC on the master template so Checkbox sees every send. Or let Notices send them. - Checkout consent. In Settings → Configure Chargebee → Checkout & Self-Serve Portal → Checkout → Show legal information, turn on Show checkbox to get consent and use renewal-consent wording. Put the full renewal terms on your own page above the button that opens Chargebee checkout.
- Price changes. Chargebee doesn't email price changes. A change you make to a subscription's recurring items is recorded as a possible price change, so Checkbox asks you to confirm the notice went out.
Rules written and maintained by the Checkbox team from the text of each law, each cited to its source. Automated checks, not legal advice.
Checkbox is compliance software, not a law firm; nothing in these docs is legal advice (details). You remain solely responsible for your subscription program, and Checkbox takes on no legal liability for it (Terms). Checkbox is a System1 company; Trust center · Status. For AI agents: every page is available as Markdown at the same URL plus .md; the index is /llms.txt.