app.stripe_events
TableRow level security on
Stripe webhook events, stored once per Stripe event id so a redelivered event is never applied twice (idempotent ingestion). The payload is the provider payload (ADR 0002).
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | Yes | Org the event concerns, resolved from the Stripe customer or subscription metadata when the event is stored; null for events of no org. It never changes afterwards.References app.organizations.id |
| stripe_event_id | text | No | Stripe event id (evt_...), unique. |
| event_type | text | No | Stripe event type, such as customer.subscription.updated. |
| livemode | boolean | No | True for live mode events; test mode events never touch live orgs. |
| stripe_created_at | timestamp with time zone | No | When Stripe created the event. |
| payload | jsonb | No | Event payload as Stripe sent it, after signature verification. |
| received_at | timestamp with time zone | No | When the webhook arrived. Set by the database. |
| processed_at | timestamp with time zone | Yes | When the event was applied. |
| processing_error | text | Yes | Why applying the event failed; it is retried. |
| attempts | smallint | No | Apply attempts so far. |
| created_at | timestamp with time zone | No | When the row was inserted. Set by the database. |
| created_by | uuid | Yes | Person who inserted the row, or null for a platform process. Set by the database.References app.people.id |
| updated_at | timestamp with time zone | No | When the row last changed. Set by the database. |
| updated_by | uuid | Yes | Person who last changed the row, or null for a platform process. Set by the database.References app.people.id |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |