Pause a subscription with POST /api/v2/subscriptions/SUBSCRIPTION_ID/pause; set pause_option=immediately for instant pause or pause_option=end_of_term to pause at the next renewal
Optionally supply unbilled_charges_handling=invoice to settle outstanding charges at pause time, or unbilled_charges_handling=delete to discard them
Confirm the subscription's status field changes to paused and that pause_date is set in the response object
Resume the subscription with POST /api/v2/subscriptions/SUBSCRIPTION_ID/resume; use resume_option=immediately or resume_option=specific_date with resume_date (Unix timestamp) for scheduled resumption
Listen for subscription_resumed webhook to update entitlements and notify downstream services
If the subscription was paused with outstanding charges deleted, verify no residual credit notes exist via GET /api/v2/credit_notes?subscription_id=SUBSCRIPTION_ID
Known gotchas
The payment_initiator parameter was added to resume_a_subscription API in a recent changelog update; omitting it on MITs may cause SCA compliance issues in regions requiring MIT flagging
Pausing a subscription with unbilled_charges_handling=delete is irreversible — deleted charges cannot be recovered
Resuming a subscription does not automatically re-enable a cancelled Chargebee hosted page; if you use hosted pages for customer self-service, regenerate the page URL after resumption
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