Pagamenti e ordini per ristoranti al dettaglio

In questa pagina

Payload completo per ristoranti al dettaglio
Modella il contesto aziendale
Controllo di avvio

Costruisci esperienze rapide per ristoranti senza separare il pagamento dall'ordine, in modo che i tuoi team di cucina e operazioni possano gestire tutto. DEUNA mantiene i modificatori degli articoli, la modalità di servizio, il negozio, gli orari e le istruzioni del cliente associati al ciclo di vita del pagamento.

Ordini basati sul menuInvia ID menu, SKU, quantità, modificatori, tasse e totali degli articoli.Contesto di consegnaRappresenta il ritiro o la consegna, i dettagli della posizione e la preparazione programmata.Orchestrazione dei pagamentiInstrada ogni tentativo attraverso i provider configurati, mantenendo lo stesso token di ordine.

Payload completo per ristoranti al dettaglio#

Gli importi utilizzano unità di valuta minori. Questo esempio modella un ritiro programmato con due articoli personalizzati e un contesto sufficiente per ricondurre il pagamento all'ordine del ristorante.

Payload completo dell’ordine

QSR

Menu, modificatori, modalità di servizio, sede, orario e istruzioni del cliente in un unico ordine di ristorazione.

Apri la guida del settore

itemsshipping_optionsscheduled_atuser_instructions

Corpo della richiestaJSON

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

Modella il contesto aziendale#

Requisito	Ordinare i campi
Menu e modificatori	`items[].id`, `sku`, `options`, `quantity`, `category`
Ritiro o consegna	`shipping_options.type`, `method`, `details.store_id`
Tempistica	`scheduled_at`, `shipping_options.details.additional_details.pickup_time`
Note di cucina o di passaggio	`user_instructions`
Fedeltà e modalità di servizio	Chiavi con namespace all'interno `metadata`

Controllo di avvio#

Mantieni coerenti gli importi degli articoli, delle tasse, degli sconti, della spedizione e del totale.
Invia il negozio che preparerà o consegnerà l'ordine.
Utilizza un timestamp ISO 8601 e il fuso orario del commerciante corretto per gli ordini programmati.
Conferma lo stato finale di pagamento tramite webhook verificati prima di rilasciare l'ordine alla consegna.
Testa scenari di ritiro, consegna, modificatore, coupon, rifiuto, retry e timeout.

Successivamente, rivedi Elaborare il pagamento di un ordine e la il flusso di lavoro e gli stati di pagamento.