How to cancel a subscription with Stripe API

1const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);
2
3async function cancelImmediately(subscriptionId) {
4  try {
5    const subscription = await stripe.subscriptions.cancel(subscriptionId);
6    console.log('Canceled:', subscription.id, subscription.status);
7    return subscription;
8  } catch (err) {
9    if (err.code === 'resource_missing') {
10      console.error('Subscription not found:', subscriptionId);
11    }
12    throw err;
13  }
14}

1async function cancelAtPeriodEnd(subscriptionId) {
2  const subscription = await stripe.subscriptions.update(subscriptionId, {
3    cancel_at_period_end: true,
4  });
5
6  const endDate = new Date(subscription.current_period_end * 1000);
7  console.log(`Subscription will cancel on: ${endDate.toISOString()}`);
8
9  return subscription;
10}

1async function cancelWithRefund(subscriptionId) {
2  // First, cancel the subscription with proration
3  const subscription = await stripe.subscriptions.cancel(subscriptionId, {
4    prorate: true,          // Generate a prorated credit
5    invoice_now: true,       // Create a final invoice with the credit
6  });
7
8  // The final invoice may have a negative amount (credit).
9  // To actually refund, retrieve the last paid invoice and refund.
10  const invoices = await stripe.invoices.list({
11    subscription: subscriptionId,
12    limit: 1,
13  });
14
15  if (invoices.data.length > 0) {
16    const lastInvoice = invoices.data[0];
17    if (lastInvoice.charge) {
18      const daysUsed = /* calculate */ 15;
19      const totalDays = 30;
20      const refundAmount = Math.round(
21        lastInvoice.amount_paid * ((totalDays - daysUsed) / totalDays)
22      );
23
24      const refund = await stripe.refunds.create({
25        charge: lastInvoice.charge,
26        amount: refundAmount, // Partial refund in cents
27      });
28      console.log('Refunded:', refund.amount);
29    }
30  }
31
32  return subscription;
33}

1async function safeCancelSubscription(subscriptionId, atPeriodEnd = true) {
2  // Retrieve current state
3  const sub = await stripe.subscriptions.retrieve(subscriptionId);
4
5  if (sub.status === 'canceled') {
6    return { message: 'Subscription is already canceled' };
7  }
8
9  if (sub.cancel_at_period_end) {
10    return {
11      message: 'Subscription is already scheduled to cancel',
12      cancel_at: new Date(sub.current_period_end * 1000).toISOString(),
13    };
14  }
15
16  if (atPeriodEnd) {
17    const updated = await stripe.subscriptions.update(subscriptionId, {
18      cancel_at_period_end: true,
19    });
20    return {
21      message: 'Subscription will cancel at period end',
22      cancel_at: new Date(updated.current_period_end * 1000).toISOString(),
23    };
24  } else {
25    const canceled = await stripe.subscriptions.cancel(subscriptionId);
26    return { message: 'Subscription canceled immediately', status: canceled.status };
27  }
28}

1// In your webhook handler:
2case 'customer.subscription.deleted': {
3  const subscription = event.data.object;
4  // Revoke access in your database
5  await db.users.update({
6    where: { stripeCustomerId: subscription.customer },
7    data: {
8      subscriptionStatus: 'canceled',
9      subscriptionId: null,
10    },
11  });
12  console.log('Access revoked for customer:', subscription.customer);
13  break;
14}