refund.reversed

A refund that succeeded was reversed.

On this page

When to use it
Payload
Example

Type	`refund.reversed`
Cause	A refund was returned after it succeeded, so the money came back to your balance.
Payload	The `refund` object in `data.object`
Subscription	On by default for a new endpoint.

When to use it

Mark the refund as not paid in your records and contact the buyer.

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_….
checkout_idstringCan be absentCan be null
The checkout session of the refunded payment, cs_….
payment_idstringCan be absentCan be null
The refunded payment, pay_….
amountinteger
The refund amount, in minor units.
currencystring
The ISO 4217 currency code.
reasonstringCan be absentCan be null
Always null in this version.
created_atstring (date-time)
When the refund was requested.
succeeded_atstring (date-time)Can be absentCan be null
When the refund succeeded. Present on refund.succeeded.
failed_atstring (date-time)Can be absentCan be null
When the refund failed. Present on refund.failed.
updated_atstring (date-time)
When the refund last changed.

Example

refund.reversed · request body

{
  "id": "whevt_7Kd2VpXn4TqB9mLzR",
  "object": "event",
  "type": "refund.reversed",
  "created_at": "2026-09-14T09:24:53Z",
  "api_version": "2026-08-01",
  "account_id": "acct_5Rn8bQ2xW7mK4tLzP",
  "data": {
    "object": {
      "id": "rfnd_9KcT4mW2xQ7bN5vLp",
      "object": "refund",
      "status": "reversed",
      "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": null,
      "updated_at": "2026-09-20T13:02:58Z"
    }
  }
}

Other refund events: refund.succeeded, refund.failed.

When to use it

Payload

Example

Related