Your Subscriptions

{subscriptions.map(sub => (

{sub.plan}

Status: {sub.status}

Next billing: {new Date(sub.nextBillingDate).toLocaleDateString()}

{sub.status === 'Active' && ( )}

))}

); } `,className:"language-javascript",language:"javascript",lang:"en"})}),` `,(0,n.jsx)(e.h2,{id:"merchant-initiated-cancellation",children:"Merchant-Initiated Cancellation"}),` `,(0,n.jsx)(e.p,{children:"Merchants can cancel subscriptions on behalf of customers using the merchant API:"}),` `,(0,n.jsx)(a,{children:(0,n.jsx)(t,{code:`// API Reference: /api/cancelsubscription const response = await fetch( \`https://api-sandbox.coinflow.cash/api/merchant/subscription/subscribers/{subscriptionId}\`, { method: 'PATCH', headers: { 'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/json' } } ); `,className:"language-javascript",language:"javascript",lang:"en"})}),` `,(0,n.jsx)(e.p,{children:"This is useful for:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsx)(e.li,{children:"Customer support scenarios"}),` `,(0,n.jsx)(e.li,{children:"Policy violations"}),` `,(0,n.jsx)(e.li,{children:"Refund situations"}),` `,(0,n.jsx)(e.li,{children:"Account closures"}),` `]}),` `,(0,n.jsx)(e.h2,{id:"cancellation-via-merchant-dashboard",children:"Cancellation via Merchant Dashboard"}),` `,(0,n.jsx)(e.p,{children:"Merchants can also cancel subscriptions through the Coinflow merchant dashboard:"}),` `,(0,n.jsxs)(e.ol,{children:[` `,(0,n.jsxs)(e.li,{children:["Log in to ",(0,n.jsx)(e.a,{href:"https://sandbox-merchant.coinflow.cash",children:"merchant dashboard"})]}),` `,(0,n.jsxs)(e.li,{children:["Navigate to ",(0,n.jsx)(e.strong,{children:"Subscriptions"})]}),` `,(0,n.jsx)(e.li,{children:"Click on the subscription plan"}),` `,(0,n.jsx)(e.li,{children:"Find the subscriber in the list"}),` `,(0,n.jsxs)(e.li,{children:["Click ",(0,n.jsx)(e.strong,{children:"Cancel Subscription"})]}),` `]}),` `,(0,n.jsx)(a,{children:(0,n.jsx)(c,{alt:"Cancel subscription from merchant dashboard",align:"center",width:"800px",border:!0,src:"https://files.readme.io/caa97670dea7d651055c3289380f75bcc714b3b197676a26a0ad5b8a9806187f-Screenshot_2024-09-04_at_2.23.04_PM.png",children:(0,n.jsx)(e.p,{children:"Merchant view showing subscription cancellation option."})})}),` `,(0,n.jsx)(e.h2,{id:"cancellation-behavior",children:"Cancellation Behavior"}),` `,(0,n.jsx)(e.h3,{id:"what-happens-when-a-subscription-is-cancelled",children:"What Happens When a Subscription is Cancelled"}),` `,(0,n.jsx)(e.p,{children:"When a subscription is cancelled:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:"Status Update"}),": Changes to ",(0,n.jsx)(e.code,{children:"Canceled"})]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:"Billing"}),": No future payments will be processed"]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:"Access"}),": Customer typically retains access until end of current billing period"]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:"Notifications"}),": Cancellation webhook is triggered"]}),` `]}),` `,(0,n.jsx)(e.h3,{id:"configuring-access-after-cancellation",children:"Configuring Access After Cancellation"}),` `,(0,n.jsx)(e.p,{children:"You can implement different access policies:"}),` `,(0,n.jsxs)(e.ol,{children:[` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:"Immediate Termination"})," - Access ends immediately upon cancellation"]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:"End of Period"})," - Access continues until the end of the current billing period (recommended)"]}),` `,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:"Grace Period"})," - Custom grace period after cancellation"]}),` `]}),` `,(0,n.jsx)(e.p,{children:"Implement your preferred policy in your application logic using the cancellation timestamp and next billing date from the subscription data."}),` `,(0,n.jsx)(e.h2,{id:"handling-cancellation-webhooks",children:"Handling Cancellation Webhooks"}),` `,(0,n.jsx)(e.p,{children:"Set up webhooks to receive cancellation notifications:"}),` `,(0,n.jsx)(a,{children:(0,n.jsx)(t,{code:`// Webhook payload for subscription cancellation { "event": "subscription.cancelled", "data": { "subscriptionId": "6851d8c378269da7d5a535d6", "customerId": "customer123", "planCode": "premium-monthly", "cancelledAt": "2024-01-20T15:45:00Z", "reason": "customer_requested" } } `,className:"language-javascript",language:"javascript",lang:"en"})}),` `,(0,n.jsx)(e.p,{children:"Handle the webhook in your backend:"}),` `,(0,n.jsx)(a,{children:(0,n.jsx)(t,{code:`app.post('/webhooks/coinflow', (req, res) => { const event = req.body; if (event.event === 'subscription.cancelled') { const { subscriptionId, customerId } = event.data; // Update your database await db.subscriptions.update({ where: { id: subscriptionId }, data: { status: 'cancelled', cancelledAt: new Date() } }); // Send cancellation email to customer await sendCancellationEmail(customerId); // Log for analytics analytics.track('Subscription Cancelled', { subscriptionId, customerId }); } res.sendStatus(200); }); `,className:"language-javascript",language:"javascript",lang:"en"})}),` `,(0,n.jsx)(e.h2,{id:"best-practices",children:"Best Practices"}),` `,(0,n.jsx)(e.h3,{id:"clear-communication",children:"Clear Communication"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsx)(e.li,{children:"Explain what happens when they cancel"}),` `,(0,n.jsx)(e.li,{children:"Show when access will end"}),` `,(0,n.jsx)(e.li,{children:"Offer alternatives (pause, downgrade)"}),` `,(0,n.jsx)(e.li,{children:"Request feedback on why they\u2019re cancelling"}),` `]}),` `,(0,n.jsx)(e.h3,{id:"retention-strategies",children:"Retention Strategies"}),` `,(0,n.jsx)(e.p,{children:"Before cancelling, consider:"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsx)(e.li,{children:"Offering a discount or special offer"}),` `,(0,n.jsx)(e.li,{children:"Suggesting a pause instead of cancel"}),` `,(0,n.jsx)(e.li,{children:"Downgrading to a lower tier"}),` `,(0,n.jsx)(e.li,{children:"Providing a feedback form"}),` `]}),` `,(0,n.jsx)(e.h3,{id:"user-experience",children:"User Experience"}),` `,(0,n.jsxs)(e.ul,{children:[` `,(0,n.jsx)(e.li,{children:"Make cancellation easy to find (don\u2019t hide it)"}),` `,(0,n.jsx)(e.li,{children:"Require confirmation but don\u2019t make it difficult"}),` `,(0,n.jsx)(e.li,{children:"Send confirmation email after cancellation"}),` `,(0,n.jsx)(e.li,{children:"Allow easy reactivation"}),` `]}),` `,(0,n.jsx)(e.h3,{id:"example-cancellation-flow",children:"Example Cancellation Flow"}),` `,(0,n.jsx)(a,{children:(0,n.jsx)(t,{code:`function CancellationFlow({ subscription, onCancel }) { const [step, setStep] = useState('confirm'); const [feedback, setFeedback] = useState(''); const handleConfirm = () => { setStep('feedback'); }; const handleSubmit = async () => { // Submit feedback (optional) if (feedback) { await submitCancellationFeedback(subscription.id, feedback); } // Proceed with cancellation await onCancel(subscription.id); setStep('complete'); }; if (step === 'confirm') { return (

Cancel {subscription.plan}?

Your subscription will remain active until {subscription.nextBillingDate}

); } if (step === 'feedback') { return (

Help us improve

Why are you cancelling? (optional)

setFeedback(e.target.value)}
          placeholder="Your feedback..."
        />
        <button onClick={handleSubmit}>Complete Cancellation</button>
      </div>
    );
  }

return (
    <div>
      <h3>Subscription Cancelled</h3>
      <p>You'll have access until {subscription.nextBillingDate}</p>
      <p>You can reactivate anytime from your account settings.</p>
    </div>
  );
}
`,className:"language-javascript",language:"javascript",lang:"en"})}),`
`,(0,n.jsx)(e.h2,{id:"reactivating-cancelled-subscriptions",children:"Reactivating Cancelled Subscriptions"}),`
`,(0,n.jsx)(e.p,{children:"Customers may want to reactivate a cancelled subscription. You\u2019ll need to create a new subscription using the same plan code:"}),`
`,(0,n.jsx)(a,{children:(0,n.jsx)(t,{code:`// Create a new subscription with the same plan
const response = await fetch(
  'https://api-sandbox.coinflow.cash/api/subscription/{merchantId}/subscribers/card',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-coinflow-auth-session-key': sessionKey
    },
    body: JSON.stringify({
      planCode: previousPlanCode,
      card: savedCardToken,
      // ... other required fields
    })
  }
);
`,className:"language-javascript",language:"javascript",lang:"en"})}),`
`,(0,n.jsx)(e.h2,{id:"related-resources",children:"Related Resources"}),`
`,(0,n.jsxs)(e.ul,{children:[`
`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:"/guides/subscriptions/implementation-methods/api-integration#webhooks",children:"Subscription Webhooks"})}),`
`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:"/guides/subscriptions/overview/understanding-your-flow-of-funds/managing-subscription-plans-subscribers",children:"Managing Subscription Plans"})}),`
`,(0,n.jsx)(e.li,{children:(0,n.jsx)(e.a,{href:"/api-reference/api-reference/subscription/cancel-customer-subscription",children:"API Reference - Cancel Subscription"})}),`
`]})]})}function f(i={}){let{wrapper:e}={...o(),...i.components};return e?(0,n.jsx)(e,{...i,children:(0,n.jsx)(g,{...i})}):g(i)}function l(i,e){throw new Error("Expected "+(e?"component":"object")+" `"+i+"` to be defined: you likely forgot to import, pass, or provide it.")}return I(A);})();
;return Component;</article></body></html>