🚧
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

Event	Chargeback Status	Description
`chargeback.pending`	`PENDING`	Triggered 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.won`	`WON`	Triggered 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.lost`	`LOST`	Triggered when a merchant loses a dispute and is now irrevocably not going to receive the money.