To pause, call POST /api/v2/subscriptions/:id/pause with pause_option set to immediately or end_of_term and optionally set resume_date
To resume, call POST /api/v2/subscriptions/:id/resume; if a resume_date was set, verify the subscription status is paused before making the call
For a plan change, call POST /api/v2/subscriptions/:id/update_for_items with the new item_price_id; set prorate set to true and end_of_term to false for an immediate switch with proration
Retrieve the resulting invoice via the subscription object's current_term_start and current_term_end fields to confirm proration credit was applied
Update your application's subscription record with the new plan_id and next_billing_at from the Chargebee response
Known gotchas
Pausing a subscription with pause_option: immediately stops billing immediately but does not refund the current period; communicate this clearly in your customer-facing UI
Proration in Chargebee can generate a credit note rather than a refund; the handling depends on the customer's credit balance setting in your Chargebee configuration
Plan changes that cross billing period boundaries may result in unexpected invoice amounts if trial days are involved; test with Chargebee's sandbox before enabling in production
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