---
title: "payment_refund_failed"
method: POST
path: "payment_refund_failed"
tags: ["Accept payments webhooks"]
---

# payment_refund_failed

`POST payment_refund_failed` (webhook)

The `payment_refund_failed` webhook is sent when a refund has failed.

## Headers

- `Getpaid-Trace-Id` string, required

## Payload

- object
  - `id` string, id, required: The unique identifier of the event.
  - `type` 'payment_refund_failed', required: The type of event.
  - `version` 'v2', required: The version of the event type.
  - `occurred_at` string, date-time, required: UTC timestamp in ISO 8601 format with milliseconds ([RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html)). Always includes the 'Z' UTC indicator.
  - `data` object, required: The event data specific to each event type and version.
    - `id` string, id, required: The unique identifier of the payment.
    - `origin` union, required
      - object
        - `type` string, required: The payment origin type. - `api`: The payment was created via the API. - `checkout`: The payment was created as an attempt of a checkout session.
      - object
        - `type` string, required: The payment origin type. - `api`: The payment was created via the API. - `checkout`: The payment was created as an attempt of a checkout session.
        - `id` string, id, required: The unique identifier of the checkout.
    - `reference` string, required: An identifier in your system. It is recommended to make it unique but the uniqueness is not enforced by the solution.
    - `refund` object, required: The refund details.
      - `id` string, id, required: The unique identifier of the refund of a payment.
      - `reference` string, required: An identifier in your system. It is recommended to make it unique but the uniqueness is not enforced by the solution.

## Acknowledgement `2XX`

Indicate success, the webhook will not be retried

## Other responses

- `429`: The webhook action will be retried according to the workflow retry schedule
- `4XX`: The webhook action will be disabled
- `5XX`: The webhook action will be retried according to the workflow retry schedule

---

[API](https://skmtc.dev/getpaid/apis/getpaid-api.md) - [All operations](https://skmtc.dev/getpaid/apis/getpaid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpaid/apis/getpaid-api/revisions/458eae3d49ad?raw)