Chargeback webhooks
API version 2023-01-01 deprecating
This version will be deprecated on May 1, 2025. If your platform is on this version, you should upgrade to at least 2023-12-01 to simplify authorization and access new features.
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 | Description |
---|---|
chargeback.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 | 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 | Triggered when a merchant loses a dispute and is now irrevocably not going to receive the money. |
Updated 6 months ago