Let's Pizza Developersv1.0.0

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#

  1. Let's Pizza → Your endpointA signed message for a new orderPOST <your URL> · order.created
  2. Your endpointChecks the signature, stores the order once
  3. Your endpoint → Let's Pizza2xx with your number: the acknowledgement{ externalOrderNo, externalReceiptNo }
  4. Your endpoint → POS and kitchenRoutes it to the branch
  5. Your endpoint → Let's PizzaStatusesPOST /partner/v1/orders/{id}/status

The request you receive#

HTTP
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.

PartnerPushMessage
{
  "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 answerWhat we do
2xxThe acknowledgement. If it carries externalOrderNo and externalReceiptNo we keep them and show them to branch staff.
408 · 429 · 5xx · timeoutRetried with growing delays, up to 8 attempts; then the push is marked failed for a person to requeue from the console.
Any other 4xxYour system refused it: not retried, shown to the team as rejected.
2xx · PartnerPushAnswer
{
  "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.

Endpoints used#