Skip to main content
A subscription management page lists a customer’s plans and lets them cancel, pause, skip or resume one. It is where most self-service cancellation reasons come from (agents add theirs from the Call Center cancel flow), so build the exit survey properly: a cancel sent without a reason shows as “Not specified” in your churn reporting. The exit survey and retention offers (cc.getManageData, cc.applyOffer) need Manage switched on in Merchant settings → Customer care; without it they return nothing. The subscription template functions (getSubscriptions, cancelSubscription, pauseSubscription, resumeSubscription, skipSubscription) work without that toggle, for every subscription your brand bills.

Listing subscriptions

getSubscriptions(status, limit) returns the logged-in customer’s subscriptions. Call it once per status you want to show.
Each subscription carries original_transaction_id, which identifies it to every call below. Keep it on the button.

Asking why, before cancelling

cc.getManageData(transactionId) returns what the customer is allowed to do, including exit_survey_reasons - the list to put in your dropdown.
If the merchant has not configured its own list, you get the standard set: These keys are identifiers, not copy. Show your own wording to the customer and send the key back. temporary_pause and too_much_product are worth watching: both usually mean the plan interval is wrong rather than the product being wrong, and both are recoverable with a retention offer.

Cancelling, with the reason attached

Pass the selected reason as the second argument. This is the step that is easy to miss, and missing it silently costs you the whole survey - the cancellation still succeeds, so nothing looks broken, and every row in your Cancel Reasons report reads “Not specified”.
Use ef.sub.cancel(reason) instead if you want to stay on the page and handle the result yourself. Both accept the reason; both work without it.

Offering something before they go

If retention offers are enabled, getManageData also returns offers. An offer can be matched to the reason the customer picked, so a price complaint gets a discount and an oversupply complaint gets a longer interval.
See Retention Offers for configuring them.

Pause, skip and resume

The built-in Manage page only cancels (or applies an offer). To let customers pause, skip a charge or resume, call the template functions from a page-based API in your members area. Each takes the subscription’s original_transaction_id and checks that it belongs to the logged-in customer. Each change shows on the subscription’s Changes tab in Reports → Subscriptions. See Subscriptions in the template engine for full examples.

Checking it worked

Cancel a test subscription, choose a reason, then open a dashboard with the Cancel Reasons card (the Subscriptions dashboard preset has it). The reason should appear by name within a minute or two. If it says “Not specified”, the reason is not reaching the server. In almost every case that is the second argument missing from cancelThenNavigate.