Guides
We call your system (connectors)
Instead of your system asking for orders, we send them: the standard connector standard_push posts one fixed-shape message per order. Used when settings.orders.delivery is connector and settings.orders.connector is standard_push.
The flow#
- Let's Pizza → Your endpointA signed message for a new order
POST <your URL> · order.created - Your endpointChecks the signature, stores the order once
- Your endpoint → Let's Pizza2xx with your number: the acknowledgement
{ externalOrderNo, externalReceiptNo } - Your endpoint → POS and kitchenRoutes it to the branch
- Your endpoint → Let's PizzaStatuses
POST /partner/v1/orders/{id}/status
The request you receive#
POST /your/orders/endpoint HTTP/1.1
Content-Type: application/json
User-Agent: LetsPizza-Connector/1
X-LP-Event: order.created
X-LP-Event-Id: 1042.order.created
Idempotency-Key: 1042.order.created (the message id, the same on every retry)
X-LP-Timestamp: 1793350800
X-LP-Signature: v1=<64 hex characters>The signature is exactly the webhooks’ one, with the connector secret shown to you once when it is set up: verification and the test vector. Deduplicate on Idempotency-Key: the same message may reach you more than once.
{
"version": 1,
"id": "1042.order.created",
"type": "order.created",
"occurredAt": "2026-11-19T19:35:02+03:00",
"partnerId": "ptn_01JD5ZB2",
"data": {
"order": {
"order": {
"id": "7f3a2c10-5b8e-4d21-9c47-1a2b3c4d5e01",
"number": "261119-0041",
"status": "placed",
"channel": "app",
"branchId": "28",
"fulfilment": "delivery",
"paymentMethod": "cash_on_delivery",
"catalogVersion": "taker-2026-10-06.5d01b76bc1",
"lines": [
{
"lineIndex": 0,
"line": {
"productId": "649",
"qty": 2,
"selections": [
{
"groupId": "1362",
"optionId": "11836",
"qty": 1
}
],
"source": {
"experience": "classic"
}
},
"unitPrice": 4200,
"lineTotal": 8400,
"snapshot": {
"names": {
"ar": "مارقريتا",
"en": "Margherita Pizza"
},
"options": [
{
"groupId": "1362",
"optionId": "11836",
"names": {
"ar": "صلصة طماطم",
"en": "Tomato Sauce"
},
"qty": 1,
"price": 0
}
]
}
},
{
"lineIndex": 1,
"line": {
"productId": "740",
"qty": 2,
"selections": [],
"source": {
"experience": "classic"
}
},
"unitPrice": 600,
"lineTotal": 1200,
"snapshot": {
"names": {
"ar": "كولا",
"en": "Coca Cola Can"
},
"options": []
}
}
],
"subtotal": 9600,
"discounts": [],
"discountTotal": 0,
"deliveryFee": 1800,
"total": 11400,
"vat": {
"rateBps": 1500,
"amount": 1487,
"includesDeliveryFee": true
},
"cutlery": false,
"ifUnavailable": "call",
"delivery": {
"address": "حي المعذر الشمالي، شارع الأمير سلطان، عمارة 14",
"details": "الدور الثاني، شقة 5، بجوار الصيدلية",
"location": {
"lat": 24.6921,
"lng": 46.6853
},
"contactName": "عبدالله",
"contactPhone": "+966500000000"
},
"createdAt": "2026-11-19T19:30:12+03:00",
"history": [
{
"from": null,
"to": "placed",
"at": "2026-11-19T19:30:12+03:00",
"actor": "customer"
}
]
},
"state": "awaiting_ack",
"ackDueAt": "2026-11-19T19:30:12+03:00",
"ackedAt": null,
"externalOrderNo": null,
"externalReceiptNo": null,
"external": {
"branchCode": "string",
"lines": [
{
"lineIndex": 0,
"code": "string",
"variant": "string",
"unit": "string",
"options": [
{
"groupId": "string",
"optionId": "string",
"code": "string",
"variant": "string"
}
]
}
],
"tenderCode": "string",
"unmapped": [
{
"kind": "branch",
"ourId": "string"
}
]
},
"updatedAt": "2026-11-19T19:30:12+03:00"
}
}
}data.order is the same item as in the order feed (PartnerOrder): the order, its state with you, the ack deadline.
Your answer#
| Your answer | What we do |
|---|---|
2xx | The acknowledgement. If it carries externalOrderNo and externalReceiptNo we keep them and show them to branch staff. |
408 · 429 · 5xx · timeout | Retried with growing delays, up to 8 attempts; then the push is marked failed for a person to requeue from the console. |
Any other 4xx | Your system refused it: not retried, shown to the team as rejected. |
{
"externalOrderNo": "WEB-ORD-000123",
"externalReceiptNo": "R-000981"
}Address and sending rules#
- Orders go out from a background job: the customer never waits for your system, and ordering never stops if it is down.
- Answer within the connector’s timeout (10 seconds by default) and do the work after answering.
- In production the address must be https and public, like webhook addresses.
- After answering you still report statuses through the API as usual.