Accept payments webhooks

checkout_completed

The checkout_completed webhook is sent when the checkout process is completed with a successful payment.

postWebhookcheckout_completed

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_completed' 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",
      "standing_instruction": {
        "id": "sti_4tbftjwzxja1h71nzas1g0g1xm",
        "status": "active"
      }
    }
  }
}

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.