stripeWebhook

Verify and translate one Stripe webhook into paykit's provider-neutral event.

Source: packages/paykit-stripe/src/Webhooks.ts Kind: Primitive

Verify and translate one Stripe webhook into paykit’s provider-neutral event.

stripeWebhook(props) returns the function a /webhooks/stripe route calls: the signature check is @distilled.cloud/stripe’s own constructEvent, then the payload is decoded and answered as the WebhookEvent handleWebhook already knows how to apply — or none for an event paykit does not model, which the route answers 200 and ignores.

The Stripe event id is the command id, so a redelivery replays rather than activating, charging or cancelling twice.

The tier comes from the price the buyer actually paid for — read in the mapping, never invented: a price no tier maps keeps the account and drops the tier rather than refusing the endpoint.

Handling a Stripe webhook

const webhook = stripeWebhook({
  secret: yield* Config.redacted("STRIPE_WEBHOOK_SECRET"),
  tiers,
});

return Effect.gen(function* () {
  const event = yield* webhook({ headers: Object.fromEntries(request.headers), body });
  if (Option.isSome(event)) yield* handleWebhook(event.value);
  return new Response(null, { status: 202 });
});