Skip to content

Order at real
restaurants

The Ordering API places real pickup and delivery orders from your app or AI agent, and sends back the restaurant's receipt.

Every order moves through four steps. Nothing is charged until the person says yes.

Building

Layout builds the cart on the restaurant's own ordering site.

Ready

Your app shows the total and the card. Nothing is charged yet.

Placing

The person said yes, and Layout pays the restaurant.

Placed

The restaurant's own receipt came back.

Your backend hears it all.

Every event is signed, sent again when your endpoint misses it, and readable later from the events feed.

  • order.carted

    The cart is ready to confirm

  • order.placed

    The restaurant's receipt came back

  • order.updated

    The pickup time arrived

  • order.unconfirmed

    Layout can't tell yet, so it never retries

  • order.refunded

    Money went back to the card

One engine, two doors. The same checks and the same money rules sit behind both.

REST

For the app you build. Pickup and delivery carts, orders and webhooks over HTTPS.

api.layout.link

MCP

For AI agents. The same orders as tools an assistant can call.

mcp.layout.link

Texts stay few.

Layout texts your user a code to link their number, and on an order that needs their approval. Cart and order update texts are on by default, and you can turn most of them off. Every text, word for word.

482913

Practice every ending.

Sandbox builds carts from real menus and ends them however you pick. Nothing is ordered or charged.

PlacedFailedUnconfirmedCard declinedPrice changedStore closedPickup laterCode neededCard challenge

Questions, answered

Seconds at a restaurant Layout already knows. At one it has not ordered from before, often one to three minutes. Your app polls the cart or waits for a webhook.

Layout. It pays the restaurant and charges the person's card for the total they approved. People connect a card through Sign in with Layout or a card link, so card numbers never reach your app.

Layout calls an order placed only once the restaurant confirms it. The order then carries the restaurant's own order number and pickup details whenever the restaurant states them.

The charge on the person's card is from Layout. Refunds and wrong orders go to Layout too, under the Refund Policy, and an order.refunded webhook can tell your backend about each one.

It reads unconfirmed, which means Layout cannot tell whether the restaurant received it. Treat it as pending and never build it again, so nobody is charged twice.

Sandbox works as soon as you create your first application. Production opens after approval, which you request from the console.

Food ordering,
without the ordering