Refund webhooks

Subscribe to refund 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.

Refunds


Webhooks can be configured to receive updates on every status change that occurs through the life cycle of a refund.

Refund statuses

Refund statuses

Refund webhook payload

The webhook payload data field represents all refund detail fields returned in the get payin endpoint.

Refund events

EventRefund StatusDescription
refund.createdCREATEDTriggered when a refund is created and waiting approval.
refund.processingPROCESSINGTriggered when a refund is approved and is currently processing.
refund.succeededSUCCEEDEDTriggered when a refund has completed processing.
refund.failedFAILEDTriggered when a refund unsuccessfully attempted to process.
refund.canceledCANCELEDTriggered when a refund is canceled before the refund completes processing.
refund.in_reviewIN_REVIEWTriggered when a refund is flagged for risk review.