API ReferenceEvent Referencewebhook.received.v1

webhook.received.v1

Constant

import { EVENT_NAMES } from "@platform/contracts";
 
EVENT_NAMES.WEBHOOK_RECEIVED_V1;

Publishers

Subscribers

Payload schema

z.object({
  webhook_event_id: z.string(),
  provider: z.enum(["stripe", "bigcommerce", "recharge", "resend", "postmark"]),
  provider_event_id: z.string(),
  event_type: z.string(),
  brand_id: z.string(),
  payload: z.record(z.unknown()),
  received_at: z.string().datetime(),
}

Delivery semantics

  • At-least-once delivery. Consumers must dedupe by event ID.
  • Fanned out to both NATS (in-cluster) and EventBridge (durable). See Events concept.