Event types
Webhook event types
Every event type matches its status transition and carries the same payload shape ({ event_id, event_type, created_at, livemode, data: { invoice } }).
| Event type | Fired when |
|---|---|
invoice.created | New invoice via POST /v1/invoices |
invoice.payment_seen | Payment in mempool, 0 conf |
invoice.paid | Payment confirmed (status: paid) |
invoice.late_paid | Payment arrived after expiry but inside grace (status: late_paid) |
invoice.expired | expires_at passed without sufficient payment |
invoice.underpaid | Confirmed payment is less than expected |
invoice.overpaid | Confirmed payment exceeds expected |
invoice.payment_reverted | Reorg invalidated a previously confirmed payment |
invoice.requires_review | Cross-check disagreement — needs manual review |
invoice.cancelled | Vendor cancelled the invoice |