refund.failed
A refund failed.
On this page
| Type | refund.failed |
|---|---|
| Cause | The refund could not be completed. |
| Payload | The refund object in data.object |
| Subscription | On by default for a new endpoint. |
When to use it
Decide how to return the money to the buyer. You can request a new refund.
Payload
The fields of data.object. The envelope is the same for every event.
- idstring
The refund ID,
rfnd_…. - objectstring
Always
refund. - statusstring
The state that this event reports.
One of:
succeeded,failed,reversed - transaction_idstring
The transaction of the refunded payment,
txn_…. The checkout session of the refunded payment,
cs_….The refunded payment,
pay_….- amountinteger
The refund amount, in minor units.
- currencystring
The ISO 4217 currency code.
Always
nullin this version.- created_atstring (date-time)
When the refund was requested.
When the refund succeeded. Present on
refund.succeeded.When the refund failed. Present on
refund.failed.- updated_atstring (date-time)
When the refund last changed.
Example
{
"id": "whevt_7Kd2VpXn4TqB9mLzR",
"object": "event",
"type": "refund.failed",
"created_at": "2026-09-14T09:24:53Z",
"api_version": "2026-08-01",
"account_id": "acct_5Rn8bQ2xW7mK4tLzP",
"data": {
"object": {
"id": "rfnd_9KcT4mW2xQ7bN5vLp",
"object": "refund",
"status": "failed",
"transaction_id": "txn_0F8mQ2rXbT4kL9pZa",
"checkout_id": "cs_6HvB2nQx9LmT4kWpR",
"payment_id": "pay_3RtN6wYc8mK2hQvJd",
"amount": 5000,
"currency": "EUR",
"reason": null,
"created_at": "2026-09-20T13:02:11Z",
"succeeded_at": null,
"failed_at": "2026-09-20T13:02:58Z",
"updated_at": "2026-09-20T13:02:58Z"
}
}
}Other refund events: refund.succeeded, refund.reversed.