This event is opt-in. You will not receive it unless you subscribe to
checkout.refunded in your webhook settings. Contact us to enable it for your account.Payload Structure
Example Response
Updating Your Internal Ledger
This event is triggered when a charge that previously succeeded is refunded to the customer — via the dashboard or the Refund a Charge endpoint. You need to “undo” the previous action — for deposits you should deduct the balance you credited when the charge succeeded.checkout.refunded differs from checkout.returned: a refund is deliberately issued back to the customer, while a return is a reversal initiated by the customer’s bank (e.g. an ACH return or chargeback). Both reverse settled funds, so your ledger handling is typically the same.
