Skip to main content
WEBHOOK

Webhook overview

Webhooks work differently to the API endpoints. Take a read of our guide to understand how they work.
This event is sent when an order fails. Together with order.completed, it replaces order.completion. Use reason to decide what to do next:
  • fraud: Runa’s fraud checks blocked the order.
  • generic: the order failed for any other reason.

Body

application/json

The failed order

Standard Webhooks envelope sent when an order fails. The order is in data.

type
string
required

Always order.failed for this event.

Allowed value: "order.failed"
timestamp
string<date-time>
required

When the order failed (RFC 3339, UTC).

Example:

"2024-01-03T14:25:07Z"

data
Failed order · object
required

Response

200

Return a 200 status to indicate that the data was received successfully