Webhooks
Event Types
Cresora webhook events, and which of them are emitted today.
⚠Warning
Planned means the event is not emitted yet. It is specified, but no Cresora service produces it, so a receiver built against it will never fire. Only Stable events are delivered today.
This page is also not the full list. For the authoritative set your API key can
subscribe to, call GET /webhook-event-types — it is served from the live event
catalog, so it cannot drift from what the platform actually emits.
Payment events
| Event | Phase | Description |
|---|---|---|
transaction.authorized | Stable | Payment authorized (manual capture mode) |
transaction.captured | Stable | Payment captured and pending settlement |
transaction.failed | Stable | Payment hard or soft declined |
transaction.refunded | Stable | Payment fully or partially refunded |
ACH events
| Event | Phase | Description |
|---|---|---|
transaction.returned | Stable | ACH payment returned by receiving bank |
ach.renotification_required | Planned | Would fire when NACHA Reg E re-notification is due for a recurring ACH plan. Today nothing is sent and detecting when it applies is your responsibility — see NACHA compliance |
Recurring billing events
| Event | Phase | Description |
|---|---|---|
recurring.invoice.upcoming | Planned | Upcoming invoice for a recurring plan (fires 72h before charge) |
contract.payment_success | Stable | Recurring plan invoice paid successfully |
contract.payment_failed | Stable | Recurring plan invoice payment failed |
Dispute events
| Event | Phase | Description |
|---|---|---|
dispute.created | Planned | Cardholder initiated a chargeback |
dispute.evidence_due | Planned | Evidence submission deadline approaching |
chargeback.resolved | Stable | Dispute resolved (won or lost) |
Terminal events (Phase 1)
| Event | Phase | Description |
|---|---|---|
terminal.transaction.completed | Phase 1 | In-person terminal transaction completed |
Webhook meta-events
| Event | Phase | Description |
|---|---|---|
webhook.test | Stable | Sent when you register a new endpoint to verify reachability |
webhook.delivery_failed | Planned | Would fire when a delivery exhausts its retries. Today nothing is sent — see Failed deliveries |
webhook.endpoint_degraded | Planned | Would fire when an endpoint's success rate degrades. Cresora tracks endpoint health internally but does not notify you |