WEBHOOK
order.completion
{
  "id": "O-01H5WQGHKCBB85MQFM68S9KJ5Q",
  "status": "PROCESSING",
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "description": "Your own reference text",
  "payment_method": {
    "type": "ACCOUNT_BALANCE",
    "currency": "USD"
  },
  "currency": "USD",
  "total_price": "10",
  "total_discount": "1"
}

Webhook overview

Webhooks work differently to the API endpoints. Take a read of our guide to understand how they work.
This event is essential when using the async ordering mode if you need to take action when an order has completed processing. It’s also useful if you want to feed ordering data into your system. The webhook payload depends on whether the order was processed successfully or not. You should use the status field to determine the type of payload you have received.
  • Successfully completed orders will have a status of COMPLETED
  • Failed orders will have a status of FAILED

Body

application/json

Sent when an order finishes processing, the body object will be one of the following schemas depending on the order status.

Webhook message sent when an order has completed processing. Used for orders that have completed. This class is typically used when returning a list of orders to the client.

id
string
required

The ID of the order.

Example:

"O-01H5WQGHKCBB85MQFM68S9KJ5Q"

status
enum<string>
required

Status of the order. The status of the order.

Available options:
COMPLETED
Example:

"PROCESSING"

created_at
string<date-time>
required

UTC timestamp, in ISO 8601 format, when the order was submitted.

payment_method
object
required

The payment method used for the order. Account balance payment.

currency
string
required

The currency of the order, represented by ISO 4217 currency codes. Please check the currency section in the guidelines for how to use this field.

Example:

"USD"

total_price
string
required

The total price of the order. This includes any applicable fees.

Example:

"10"

total_discount
string
required

The total discount of the order.

Example:

"1"

completed_at
string<date-time>

UTC timestamp, in ISO 8601 format, when the order was completed.

description
string

Free format text reference for the order. Not visible to the end user. Will be visible to you in the Runa web portal.

Maximum length: 128
Example:

"Your own reference text"

Response

200

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