Accept payments webhooks

checkout_failed

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.

postWebhookcheckout_failed

Headers

Getpaid-Trace-Idstring required

Example:96ce50247f87f540bb2d86771b3728b8

The trace identifier for the request. It is a good idea to log this and provide it with any support requests

Payload

idstring 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_atstring date-time required

UTC timestamp in ISO 8601 format with milliseconds (RFC 3339). Always includes the 'Z' UTC indicator.

Example payload

{
  "id": "evt_4a4m2pjycdb1jbj68h1rvk9kcz",
  "version": "v2",
  "occurred_at": "2025-09-01T22:05:48.479Z",
  "data": {
    "id": "cko_4kf9v6xp00hzc99rdwr5m97wce",
    "reference": "ORD-202510-0232",
    "payment": {
      "id": "pay_4a4m2pjycdb1jbj68h1rvk9kcz"
    }
  }
}

Response

Indicate success, the webhook will not be retried

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.