order.updated
Order updated (order.updated). Sent to an installation granted read_orders.
Authorizations
Section titled "Authorizations"Parameters
Section titled "Parameters"Header Parameters
Section titled "Header Parameters"The message id, the same on every attempt: deduplicate on it.
Seconds since the epoch at this attempt; refuse one too far from now.
v1, + base64 HMAC-SHA256 of {webhook-id}.{webhook-timestamp}.{body} with the signing secret (Standard Webhooks).
Request Bodyrequired
Section titled "Request Bodyrequired"object
The webhook type.
When the event happened, UTC with six fractional digits (2026-11-13T09:30:00.123456Z).
The organization it happened in (org_...).
object
The order’s public id (ord_...).
The number the merchant and the buyer know, as the store shows it; null when the store gives none.
The store’s own id of the order.
The store integration (int_..., see /integrations) it came from; null once that integration was removed.
The store’s vendor code: shopify, woocommerce, trendyol, test_store; app for a partner’s app that is a store (which one: integration_id). New values may appear: treat one you do not know as such.
Derived from the facts, never set by hand or by the store: checking, needs_attention, to_process, processed, cancelled, closed. New values may appear: treat one you do not know as such.
The store’s own fulfillment state (filter[fulfillment_status]): unfulfilled, partial, fulfilled, shipped, delivered, returned, restocked, on_hold; null when the store gives none. New values may appear: treat one you do not know as such.
How the order came back (filter[returns]): in_store (marked returned in the store), by_courier (the parcel brought back, until the store restocks, cancels or closes the order). Empty when neither.
When its AWB and invoice were last printed from the app; null while never printed (filter[printed]=printed or not_printed). An AWB undone clears it.
The open issues, blocking first; at most 250. Codes only: the app words them.
object
The exact problem, a stable snake_case code (phone_invalid). Order: address_missing, field_missing, field_too_long, phone_invalid, postal_code_invalid, region_not_found, locality_not_found, locality_sector_missing, payment_method_missing, payment_method_unmapped, pickup_point_missing, pickup_point_unidentified, correction_conflict, correction_conflict_emptied, delivery_service_released. AWB: route_unavailable, route_
The step it holds: awb or invoice. New values may appear: treat one you do not know as such.
The field path (shipping.phone, order.total_weight); null for the order as a whole.
Missing, invalid, not_found, mismatch, unconfigured, conflict, suspicious. New values may appear: treat one you do not know as such.
Blocking (stops its step) or warning. New values may appear: treat one you do not know as such.
Who placed it: the billing contact, else the shipping one.
object
The address the invoice is made out to; null when the store sent none.
object
The fiscal code (CUI, VAT number), for a company.
Where the parcel goes (for a pickup point, only the contact counts); null when the store sent none.
object
The fiscal code (CUI, VAT number), for a company.
In the store’s order; at most 250 (see line_items_count).
object
The product’s name, as sold.
A decimal string, trailing zeros trimmed (2).
One unit before discounts, in the store’s price convention (prices_include_tax).
object
The line’s discount, its share of order discounts included.
object
A percentage (19.0000).
object
The line after every discount, tax included.
object
Every line of the order, also those past the list’s bound.
object
The store’s own id of the shipping method.
The method’s name, as the buyer saw it.
Before discounts, in the store’s price convention.
object
object
object
After discounts, tax included.
object
object
object
Signed: a surcharge positive, an adjustment negative; tax included.
object
ISO 4217; every amount of the order is in it.
Whether the store’s prices (unit prices, subtotal, shipping prices) include tax.
object
object
object
object
object
object
object
Cod, card, bank_transfer, cash, gift_card, store_credit, other; null while the store’s gateway is not mapped. New values may appear: treat one you do not know as such.
Pending, authorized, partially_paid, paid, partially_refunded, refunded, voided, failed, not_applicable; null when the store gives none. New values may appear: treat one you do not know as such.
Cash on delivery: what is left to collect from the buyer; null without.
object
object
What the buyer asked: address, pickup_point, store_pickup, mixed (a shipment’s delivery_method takes the first two). New values may appear: treat one you do not know as such.
The carrier the buyer picked at checkout for a delivery to the door; null for any or another type.
The point the buyer picked; null unless type is pickup_point.
object
The point’s id in its provider’s ids; null while the store named none.
Whose ids the point’s id is in.
The courier service the AWB ships with; null until one is picked.
object
The courier connection (int_...).
In that connection’s service codes.
Manual (the merchant), rule (a delivery rule), fallback (the organization’s default). New values may appear: treat one you do not know as such.
The parcel’s weight in kilograms (the store’s, or the merchant’s correction).
When the buyer placed it, as the store says.
When it last changed at its store, as the store says (a store app’s updated_at, to the microsecond): the version held, which a store app compares with its own.
Responses
Section titled "Responses"Gone: no more webhooks are sent to this URL until its partner turns them back on.
Received. Any other answer is retried on the schedule.