Event types

Checkout.com sends webhooks for a number of event types.

To subscribe to certain event types, follow the instructions in webhook management.

List of event types

Webhook event type

Description

card_verified View a card verified webhook example

Card verified
Occurs when a card verification is successful.

card_verification_declined\ View a card declined webhook example

Card verification declined
Occurs when a card verification is not approved.

dispute_canceled\ View a dispute canceled webhook example

Dispute canceled
Occurs when a dispute is canceled by the issuing bank and your account is credited back the disputed amount.

dispute_evidence_required\ View a dispute evidence required webhook example

Dispute evidence required
Notifies you that you need to respond to a dispute, and that your account has been debited the disputed amount.

dispute_expired\ View a dispute expired webhook example

Dispute expired
Notifies you that you can no longer respond to a dispute, because the time limit to take action has been exceeded.

dispute_lost\ View a dispute lost webhook example

Dispute lost
Notifies you that the issuing bank has rejected your evidence and you have lost the dispute.

dispute_resolved\ View a dispute resolved webhook example

Dispute resolved
Occurs when we automatically resolve the dispute because it had already been refunded.

dispute_won\ View a dispute won webhook example

Dispute won
Notifies you that the issuing bank has accepted your evidence and you have won the dispute. Your account has been credited back the disputed amount.

payment_approved\ View a payment approved webhook example

Payment approved
Occurs when an acquirer or provider approves a payment.

payment_pending\ View a payment pending webhook example

Payment pending
Occurs on asynchronous payments when further action is required.

payment_declined\ View a payment declined webhook example (for payments) or a payment declined webhook example (for card payouts)

Payment declined
Occurs when a payment times out, or is declined by the acquirer or provider.​

payment_expired\ View a payment expired webhook example

Payment expired
Occurs when the merchant generates an alternative payment link but the customer fails to access it to complete the payment.

payment_voided\ View a payment voided webhook example

Payment voided
Occurs when an acquirer voids an authorized payment. ​

payment_canceled\ View a payment canceled webhook example

Payment canceled
Occurs when an end user cancels the payment through the provider’s interface.

payment_void_declined\ View a payment void declined webhook example

Payment void declined
Occurs when a void attempt times out, or is declined by the acquirer or provider.

payment_captured\ View a payment captured webhook example

Payment captured
Occurs when an acquirer captures an authorized card payment, or when the provider completes an alternative payment capture.​

payment_capture_declined\ View a payment capture declined webhook example

Payment capture declined
Occurs when a capture times ​out, or is declined by the acquirer.

payment_capture_pending\ View a payment capture pending webhook example

Payment capture pending
Occurs when an acquirer is in the process of capturing a payment.

payment_refunded\ View a payment refunded webhook example

Payment refunded
Occurs when an acquirer refunds a captured payment​.

payment_refund_declined\ View a payment refund declined webhook example

Payment refund declined
Occurs when a payment refund times out, or is declined by an acquirer​.

payment_refund_pending\ View a payment refund pending webhook example

Payment refund pending
Occurs when an acquirer is in the process of​ refunding a payment.

payment_chargeback\ View a payment chargeback webhook example

Payment chargeback
Occurs when a chargeback is requested for a payment. ​

payment_retrieval\ View a payment retrieval webhook example

Payment retrieval
Occurs when a retrieval is requested for a payment.​

source.updated\ View a source updated webhook example

Source updated
Occurs when a payment source has been updated.

payment_paid\ View a payment paid webhook example\ Only applies to payouts

Payment paid
Occurs when a payout is made to a card.

📘

Receiving a payment_captured notification via webhooks is the only way to confirm a payment completes successfully.

Get event types (API)

Use this API request to view all available event types.

Endpoints

Live

GEThttps://api.checkout.com/event-types

Sandbox

GEThttps://api.sandbox.checkout.com/event-types

Header parameters

Header

Value

Authorization Required

secret key

Use the valid secret key of your Checkout.com account. You can find this in the Hub.

Content-Type\ Required

application/json

Query parameters

Query parameter

version Optional

The version of the API that you wish to retrieve events for. Use version=1.0 for the legacy API and ?version=2.0 for the Unified Payments API. If you do not use this parameter, event types for both versions will be returned.

Can we help?

Thanks for using Checkout.com. If you need any help or support, then message our support team at [email protected].