Pagos y pedidos para restaurantes rápidos

En esta página

Payload completo para restaurantes rápidos
Modela el contexto de negocio
Lista de verificación de producción

Construir experiencias rápidas para restaurantes sin separar el pago del pedido, para que los equipos de cocina y operaciones puedan gestionarlo. DEUNA mantiene los modificadores de artículos, el modo de servicio, la tienda, el horario y las instrucciones del cliente asociados al ciclo de vida del pago.

Pedidos conscientes del menúEnviar IDs de menú, SKUs, cantidades, modificadores, impuestos y totales de artículos.Contexto de cumplimientoRepresentar recogida o entrega, detalles de ubicación y preparación programada.Orquestación de pagosDirigir cada intento a través de los proveedores configurados, manteniendo el mismo token de pedido.

Payload completo para restaurantes rápidos#

Los importes utilizan unidades monetarias menores. Este ejemplo modela una recogida programada con dos artículos personalizados y suficiente contexto para reconciliar el pago con el pedido del restaurante.

Payload completo de la orden

QSR

Menú, modificadores, modalidad de servicio, ubicación, horario e instrucciones del cliente en una sola orden de restaurante.

Abrir guía de la industria

itemsshipping_optionsscheduled_atuser_instructions

Cuerpo de la solicitudJSON

{
  "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"
    }
  }
}

Modela el contexto de negocio#

Requisito	Campos de orden
Menú y modificadores	`items[].id`, `sku`, `options`, `quantity`, `category`
Recogida o entrega	`shipping_options.type`, `method`, `details.store_id`
Tiempo	`scheduled_at`, `shipping_options.details.additional_details.pickup_time`
Notas de cocina o transferencia	`user_instructions`
Lealtad y modo de servicio	Claves con nombre dentro `metadata`

Lista de verificación de producción#

Mantener consistentes los importes de artículos, impuestos, descuentos, envío y totales.
Indicar la tienda responsable de preparar o completar el pedido.
Utilizar una marca de tiempo ISO 8601 y la zona horaria correcta del comerciante para los pedidos programados.
Confirmar el estado final del pago a través de webhooks verificados antes de liberar el pedido para su cumplimiento.
Probar los escenarios de recogida, entrega, modificación, cupón, rechazo, reintento y tiempo de espera.

Revisar Procesar el pago de un pedido y la el flujo de pago y los estados.