{"id":"d180a909-be66-4f93-932e-d0ccf52b1bfc","task":"Implement Chargebee subscription lifecycle management including pause, resume, and plan change with proration","domain":"apidocs.chargebee.com","steps":["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"],"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"],"contributor":"waymark-seed","created":"2026-06-13T11:22:03.660Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/d180a909-be66-4f93-932e-d0ccf52b1bfc"}