Chargeback webhooks

Subscribe to chargeback webhooks for updates on status changes

🚧

Upgrade to the latest version

These docs are for version 2023-12-01. We encourage you to upgrade to version 2024-10-16 to access new features. Please see the changelog for more information.

Chargebacks


Webhooks can be configured to receive updates on every status change that occurs through the lifecycle of a chargeback.

Chargeback webhook payload

The webhook payload data field represents all chargeback detail fields returned by the get chargeback endpoint.

Chargeback events

EventChargeback StatusDescription
chargeback.pendingPENDINGTriggered when a cardholder disputes a card payment. The amount of the chargeback and applicable fees will be subtracted from the merchant's next deposit. The merchant now has a window to submit evidence to try to win the dispute. The chargeback remains in this state until a final won or loss decision has been made.
chargeback.wonWONTriggered when a merchant wins the dispute and gets their money back. The amount of the chargeback that is won will be returned to the merchant in their next deposit.
chargeback.lostLOSTTriggered when a merchant loses a dispute and is now irrevocably not going to receive the money.