# Cancellation Flow Configuration

APIs for managing membership cancellation flow settings including retention offers, survey questions, and cancel confirmation screens

## Get cancellation flow configuration

 - [GET /api/external/v2/cancellation-managements/{id}](https://developers.membership.appstle.com/admin-api-swagger/cancellation-flow-configuration/getcancellationmanagementv2.md): Retrieves the cancellation management settings for the shop, controlling how members cancel subscriptions. These settings define the cancellation experience including retention offers, surveys, and confirmation flows.

Key Configuration Returned:
- Cancellation Reasons: Predefined list of reasons members can select
- Retention Offers: Discounts or perks offered to prevent cancellations
- Survey Questions: Custom questions to gather cancellation feedback
- Confirmation Settings: Text and buttons for cancel confirmation screen
- Minimum Cycle Requirements: Enforce minimum subscription duration before canceling
- Win-Back Campaigns: Settings for re-engagement after cancellation
- Plan-Specific Rules: Different cancellation flows per membership plan

Cancellation Flow Elements:
- Reason Selection: Dropdown/radio options for why member is canceling
- Feedback Collection: Open-text fields for additional comments
- Retention Step: Show special offers before final cancellation
- Alternative Options: Pause, skip, or frequency change suggestions
- Confirmation Screen: Final confirmation with cancel button text
- Email Notifications: Trigger cancellation confirmation emails

Retention Offer Configuration:
- Discount percentage or fixed amount off
- Number of cycles the retention discount applies
- Eligibility rules (new members only, all members, etc.)
- Display message and call-to-action text
- Success/failure handling

Use Cases:
- Build custom cancellation flows in member portals
- Display retention offers programmatically
- Integrate cancellation reasons with analytics platforms
- Customize cancel experience per membership tier
- Show plan-specific retention messaging
- Enforce business rules around cancellations

Common Cancellation Reasons:
- Too expensive
- No longer need the product
- Delivery issues
- Product quality concerns
- Switching to competitor
- Moving/relocating

Authentication: Requires API key authentication via X-API-Key header or api_key parameter