Payment events
| Event | Description | When it fires |
|---|---|---|
payment.created | A new payment has been created. | Immediately after POST /v1/payments inserts the transaction record. |
payment.authorized | Payment was authorized by the provider. | After the upstream provider confirms authorization (Everest flow). |
payment.requires_3ds | 3D Secure authentication is required. | When the provider returns a 3DS challenge for the customer to complete. |
payment.requires_consent | Auto-debit consent is required. | Everest-specific: after authorization, when consent must be confirmed before capture. |
payment.captured | Payment was successfully captured. Funds will be settled. | After the full payment flow completes successfully. This is the primary success event. |
payment.failed | Payment failed or was declined. | When the payment is declined by the issuer, provider, or when consent is rejected. |
Refund events
| Event | Description | When it fires |
|---|---|---|
refund.created | A refund has been initiated. | After POST /v1/refunds creates the refund record. |
Event payload examples
Each event shares the same top-level structure —event, data, and timestamp — but the contents of data vary by event type. Expand any event below to see its full payload.
payment.created
payment.created
Fired immediately after a new payment record is inserted.
payment.captured
payment.captured
Fired when the payment completes successfully and funds are queued for settlement. This is the primary success event to act on.
payment.failed
payment.failed
Fired when a payment is declined by the issuer, rejected by the provider, or when consent is denied.
payment.requires_3ds
payment.requires_3ds
Fired when the provider returns a 3D Secure challenge that the customer must complete before the payment can proceed.
payment.authorized
payment.authorized
payment.requires_consent
payment.requires_consent
Fired after authorization when Everest requires the customer to confirm auto-debit consent before the payment can be captured.
refund.created
refund.created
Fired after a refund record is created. The refund amount is in minor units.
Payment lifecycle
The events your integration receives depend on the payment flow. Use the sequences below to understand what to expect for each scenario. Happy path — standard card payment:Webhook amounts are in minor units (cents). Divide by 100 for EUR, GBP, USD, and most currencies. See the API response for the decimal string representation.