payments

Create a Stripe Customer per user, then create a Subscription with a Price ID and optional trial_period_days using payment_behavior 'default_incomplete'. Store the subscription ID and status in your database, and handle lifecycle events through webhooks.

Stripe offers the most flexibility and best API at 2.9% + $0.30 but you handle tax/VAT yourself. Paddle and LemonSqueezy act as merchant of record and handle tax for you at 5% + $0.50, with less customization.

Disable the body parser and pass the raw request buffer to stripe.webhooks.constructEvent with your webhook secret to verify signatures. Store processed event IDs in the database to ensure idempotency and prevent duplicate processing.

Install the Stripe CLI, run 'stripe login', then 'stripe listen --forward-to localhost:3000/api/webhooks/stripe' to forward events. Use 'stripe trigger checkout.session.completed' to simulate specific events during development.

Verification fails when the request body is parsed before verification, since signatures require the raw body. Disable the framework's body parser for the webhook route and pass the raw buffer to constructEvent.

Create a Price with recurring.usage_type set to 'metered' and an aggregate_usage mode like 'sum'. Report consumption by calling createUsageRecord on the subscription item with a quantity and timestamp whenever usage occurs.