Pagamentos e pedidos para restaurantes rápidos

Nesta página

Payload completo para restaurante rápido
Modelar o contexto de negócios
Lista de verificação de produção

Crie experiências rápidas sem separar o pagamento do pedido, para que suas equipes de cozinha e operações possam gerenciar. A DEUNA mantém modificadores de itens, modo de serviço, loja, horário e instruções do cliente associados ao ciclo de vida do pagamento.

Pedidos com contexto de menuEnvie IDs de menu, SKUs, quantidades, modificadores, impostos e totais de itens.Contexto de entregaRepresente coleta ou entrega, detalhes de localização e preparação agendada.Orquestração de pagamentoRoteie cada tentativa através dos provedores configurados, mantendo o mesmo token de pedido.

Payload completo para restaurante rápido#

Os valores usam unidades monetárias menores. Este exemplo modela uma coleta agendada com dois itens personalizados e contexto suficiente para reconciliar o pagamento com o pedido do restaurante.

Payload completo do pedido

QSR

Cardápio, modificadores, modalidade de serviço, local, horário e instruções do cliente em um único pedido de restaurante.

Abrir guia do setor

itemsshipping_optionsscheduled_atuser_instructions

Corpo da solicitaçãoJSON

{
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "qsr-2048",
    "store_code": "mad-gran-via-01",
    "currency": "EUR",
    "items_total_amount": 2890,
    "sub_total": 2890,
    "total_tax_amount": 286,
    "total_amount": 3176,
    "items": [
      {
        "id": "meal-smash-01",
        "sku": "SMASH-COMBO",
        "name": "Smash burger combo",
        "description": "Burger, fries, and drink",
        "options": "medium; no onions; sparkling water",
        "quantity": 1,
        "category": "combos",
        "taxable": true,
        "unit_price": {
          "amount": 1890,
          "currency": "EUR",
          "currency_symbol": "€"
        },
        "total_amount": {
          "amount": 1890,
          "original_amount": 1890,
          "currency": "EUR",
          "currency_symbol": "€",
          "total_discount": 0
        },
        "tax_amount": {
          "amount": 172,
          "currency": "EUR",
          "currency_symbol": "€"
        }
      },
      {
        "id": "side-wings-06",
        "sku": "WINGS-6",
        "name": "Six hot wings",
        "options": "chipotle sauce",
        "quantity": 1,
        "category": "sides",
        "taxable": true,
        "unit_price": {
          "amount": 1000,
          "currency": "EUR",
          "currency_symbol": "€"
        },
        "total_amount": {
          "amount": 1000,
          "original_amount": 1000,
          "currency": "EUR",
          "currency_symbol": "€",
          "total_discount": 0
        },
        "tax_amount": {
          "amount": 114,
          "currency": "EUR",
          "currency_symbol": "€"
        }
      }
    ],
    "shipping_options": {
      "type": "pickup",
      "method": "counter",
      "requires_shipping": false,
      "details": {
        "store_id": "mad-gran-via-01",
        "store_name": "Gran Vía",
        "address": "Calle Gran Vía 42, Madrid",
        "address_coordinates": {
          "lat": 40.4201,
          "lng": -3.7058
        },
        "contact": {
          "name": "Gran Vía team",
          "phone": "+34910000000"
        },
        "additional_details": {
          "pickup_time": "2026-10-03T18:30:00Z",
          "stock_location": "Front counter"
        }
      }
    },
    "scheduled_at": "2026-10-03T18:30:00Z",
    "user_instructions": "Label the order for Alex. Include napkins.",
    "payer_info": {
      "email": "alex@example.com",
      "external_registration_date": "2024-02-10T12:00:00Z"
    },
    "channel_type": "mobile_app_ios",
    "metadata": {
      "vertical": "qsr",
      "service_mode": "pickup",
      "loyalty_member_id": "LOY-88201"
    },
    "callback_urls": {
      "on_success": "https://merchant.example.com/payments/success",
      "on_pending": "https://merchant.example.com/payments/pending",
      "on_reject": "https://merchant.example.com/payments/rejected",
      "on_canceled": "https://merchant.example.com/payments/canceled",
      "on_failed": "https://merchant.example.com/payments/failed"
    }
  }
}

Modelar o contexto de negócios#

Requisito	Campos de pedido
Menu e modificadores	`items[].id`, `sku`, `options`, `quantity`, `category`
Coleta ou entrega	`shipping_options.type`, `method`, `details.store_id`
Tempo	`scheduled_at`, `shipping_options.details.additional_details.pickup_time`
Notas da cozinha ou transferência	`user_instructions`
Lealdade e modo de serviço	Chaves nomeadas dentro `metadata`

Lista de verificação de produção#

Mantenha os valores de item, imposto, desconto, envio e total consistentes internamente.
Envie a loja que preparará ou entregará o pedido.
Use um timestamp ISO 8601 e o fuso horário do comerciante correto para pedidos agendados.
Confirme o estado final de pagamento através de webhooks verificados antes de liberar o pedido para a entrega.
Teste cenários de coleta, entrega, modificador, cupom, rejeição, repetição e timeout.

Em seguida, revise Processar o pagamento do pedido e o fluxo de pagamento e status.