Create a subscription with POST /api/v2/subscriptions using customer, subscription.plan_id, subscription.trial_end (Unix timestamp) or subscription.trial_period_days, and billing_address fields
Set subscription.auto_collection=on to enable automatic charge collection; set to off for manual invoicing workflows
Retrieve the hosted payment page URL with POST /api/v2/hosted_pages/checkout_new to let customers self-serve their subscription start
Listen for subscription_trial_end_reminder webhook (fires before trial ends) to prompt customers to add a payment method
On subscription_activated event webhook, confirm that subscription.status equals active before fulfilling entitlements
Retrieve subscription details and upcoming invoice with GET /api/v2/subscriptions/SUBSCRIPTION_ID?include[]=subscription_items
Known gotchas
Chargebee's API base URL is site-specific: https://SITE_NAME.chargebee.com/api/v2 — using a generic URL without the site subdomain returns a 404
The trial_end parameter expects a Unix timestamp in seconds; passing a JavaScript millisecond timestamp causes incorrect trial dates without error
auto_collection=on requires a valid payment method on the customer; enabling it without a stored card results in an invoice.not_paid event at trial end rather than a charge
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp