Implement subscription cancellation with retention flow

[Smartdevs17]

Implement subscription cancellation with retention flow

Description

Context: Subscription cancellations often represent lost revenue that could be saved through retention offers, feedback collection, or win-back campaigns.

Current Limitation: The contract treats cancellation as an immediate, permanent termination with no retention mechanism or feedback loop.

Expected Outcome: Implement a comprehensive cancellation flow with retention offers, feedback collection, delayed cancellation, and reactivation capabilities.

Acceptance Criteria

• Implement cancellation_flow states: REQUESTED, RETENTION_OFFER_PENDING, FEEDBACK_PENDING, SCHEDULED, COMPLETED, REACTIVATED
• Add configurable retention offers (discount, pause, upgrade) presented before cancellation
• Implement feedback collection with required/optional survey questions
• Add scheduled cancellation (end of billing period) vs immediate cancellation options
• Implement cancellation cooling-off period with reactivation window
• Add retention analytics tracking for retention offer effectiveness
• Create React Native cancellation flow UI with all states
• Write tests for cancellation flow state transitions

Technical Scope

Files Likely Affected:

• contracts/subscription/src/cancellation.rs - New cancellation module
• contracts/subscription/src/retention.rs - Retention offers
• app/stores/cancellationStore.ts - New cancellation state
• app/screens/CancellationFlowScreen.tsx - New cancellation UI

APIs/Contracts Involved:

• request_cancellation(subscription_id: SubscriptionId, type: CancelType) -> CancellationFlow
• offer_retention(subscription_id: SubscriptionId, offer: RetentionOffer) -> CancellationFlow
• submit_feedback(subscription_id: SubscriptionId, feedback: Feedback) -> CancellationFlow
• reactivate_subscription(subscription_id: SubscriptionId) -> Subscription
• get_cancellation_analytics(merchant_id: MerchantId) -> RetentionAnalytics

Edge Cases to Consider:

• Reactivation after cancellation scheduled
• Multiple cancellation requests for same subscription
• Cancellation during active charging attempt
• Retention offer expiration
• Subscriber death/incapacitation handling

[Francis6-git]

@Francis6-git has applied to work on this issue as part of the Stellar Wave Program's 4th wave.

Can I work on this.
I’ll implement a full cancellation flow with defined states, add retention offers and feedback collection, support immediate vs end-of-period cancellation with a reactivation window, track retention analytics, integrate a React Native flow UI, and cover all state transitions and edge cases with tests.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Francis6-git to this issue.

[drips-wave]

Congratulations, @Francis6-git! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on April 29, 2026.

🧑‍💻 @Francis6-git: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @Francis6-git as part of the Stellar Wave Program's 4th Wave 🥳

😎 @Francis6-git: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.