order.failed

Sent when a payment attempt fails or expires.

WEBHOOK order.failed

Example

{
  "id": "LCSWHD-9F3A7C21B4D85E60A1C2D3E4F5061728",
  "type": "order.failed",
  "created": 1791533643,
  "event_id": "q3Zk9mVx",
  "attribution": {
    "channel": "partner_api",
    "api_client_id": "LCSCLI-EXAMPLECLNT2345EXAMP",
    "checkout_session_id": null,
    "partner_reference": "cart-8841"
  },
  "data": {
    "order": {
      "id": "Hk2mQ8vR",
      "order_code": "LC-7K2M9X",
      "event_id": "q3Zk9mVx",
      "status": "failed",
      "currency": "UGX",
      "subtotal": 50000,
      "discount_total": 0,
      "donation_total": 0,
      "laces_fee": 2400,
      "total": 52400,
      "failure_kind": "timed_out",
      "ticket_count": 1,
      "attribution": {
        "channel": "partner_api",
        "api_client_id": "LCSCLI-EXAMPLECLNT2345EXAMP",
        "checkout_session_id": null,
        "partner_reference": "cart-8841"
      },
      "hold_expires_at": null,
      "created_at": "2026-10-09T08:14:03.000Z"
    }
  }
}

Headers

X-Laces-Signature · string · required

X-Laces-Event · string · required

X-Laces-Delivery · string · required

Delivery id, equal to the payload id. Constant across retries.

User-Agent · string

Body

application/json

id · string · required

Delivery id, equal to X-Laces-Delivery.

type · enum<string> · required

Available options: order.paid, order.failed, order.refunded

created · integer · required

Unix seconds when queued. Constant across retries.

event_id · string · required

attribution · object · required

How the order came in.

Show child attributes

data · object · required

Show child attributes

Response

200

Any 2xx within 10 seconds acknowledges the delivery. Anything else is retried (1m, 5m, 30m, 2h, 6h, 12h).