Stripe

import Stripe from "stripe";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

await stripe.subscriptions.create(
  {
    customer: customerId,
    items: [{ price: "price_123", quantity: 2 }],
    trial_period_days: 14,
    expand: ["latest_invoice.payment_intent"],
  },
  { idempotencyKey: key },
);

const intent = await stripe.paymentIntents.create({ amount: 1999, currency: "usd", customer: customerId });

await stripe.subscriptions.update(subscription.id, { cancel_at_period_end: true, proration_behavior: "none" });

Let stripe be a Stripe client using the API key the STRIPE_SECRET_KEY environment variable.

Create a Stripe subscription for the customer customer ID with the price "price_123" (quantity 2):
  • with a 14-day free trial
  • also loading latest invoice's payment intent in full
  • idempotency key key, so a retry won't do it twice

Let intent be a new Stripe payment intent for 1999 (cents) in USD for the customer customer ID.

Update the subscription:
  • set to cancel at the end of the current billing period
  • without prorating the change

import Stripe from "stripe";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

export async function handleWebhook(body: string, signature: string) {
  const event = stripe.webhooks.constructEvent(body, signature, endpointSecret);
  switch (event.type) {
    case "invoice.paid":
      await markPaid(event.data.object);
      break;
    case "customer.subscription.trial_will_end":
      await sendTrialReminder(event.data.object);
      break;
    default:
      console.log(`Unhandled event type ${event.type}`);
  }
}

Let stripe be a Stripe client using the API key the STRIPE_SECRET_KEY environment variable.

To handle webhook (async), given body and signature:
  Let event be the Stripe event in body, after checking it really came from Stripe (signature signature, webhook secret endpoint secret).
  Depending on what kind of Stripe event event is:
    • If it is "invoice.paid" (an invoice was paid):
      Mark paid (the Stripe object event is about).
    • If it is "customer.subscription.trial_will_end" (a free trial ends in three days):
      Send trial reminder (the Stripe object event is about).
    • For any other event:
      Log "Unhandled event type {event's type}".

import Stripe from "stripe";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

for await (const customer of stripe.customers.list({ limit: 100 })) {
  await syncCustomer(customer);
}

Let stripe be a Stripe client using the API key the STRIPE_SECRET_KEY environment variable.

For each customer in all Stripe customers, fetched page by page (up to 100 per page):
  Sync customer (customer).