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

# checkout_failed

`POST checkout_failed` (webhook)

The `checkout_failed` webhook is sent when the checkout lifetime is reached without a successful payment attempt, and at least one payment was attempted but none were successful.

It can be received days after the checkout is created depending on the payment method selected.

## Headers

- `Getpaid-Trace-Id` string, required

## Payload

- object
  - `id` string, id, required: The unique identifier of the event.
  - `type` 'checkout_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 checkout.
    - `origin` object, required
      - `type` string, required: The checkout origin type. - `api`: The checkout was created via the API.
    - `reference` string, required: An identifier in your system. It is recommended to make it unique but the uniqueness is not enforced by the solution.
    - `payment` object, required: The last payment failed associated with the checkout.
      - `id` string, id, required: The unique identifier of the payment.
      - `method` object, required: The payment method used.
        - `type` 'card' | 'sepa_direct_debit', required: The type of payment method.

## 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)