Pagamenti e ordini per cinema

In questa pagina

Payload completo dell'ordine per il cinema
Modella il contesto aziendale
Controllo di avvio

Mantieni biglietti, posti assegnati, servizi di ristorazione e pagamento all'interno di un unico ciclo di vita dell'ordine. DEUNA consente ai team del cinema di vendere l'intera esperienza, mantenendo il contesto dell'evento necessario per emettere i biglietti e supportare i clienti.

Checkout consapevole della proiezioneAllega la data dell'evento, la sede, la città, il paese e gli identificatori della proiezione.Posti a sedere e titolare del bigliettoConserva i posti assegnati e l'indirizzo email in cui viene inviato il biglietto digitale.Biglietti e servizi di ristorazioneCombina l'ingresso e gli articoli di ristorazione con prezzi e tasse a livello di articolo.

Payload completo dell'ordine per il cinema#

I dettagli dell'evento sono disponibili in shipping_options.details, mentre i biglietti e i servizi di ristorazione rimangono elementi separati per le operazioni e la riconciliazione.

Payload completo dell’ordine

Cinema

Proiezione, sede, posti assegnati, consegna dei biglietti e concessioni in un unico ciclo d’ordine.

Apri la guida del settore

itemsshipping_options.details.event_dateevent_seatingrecipient_email

Corpo della richiestaJSON

{
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "cinema-77821",
    "store_code": "mx-polanco-12",
    "currency": "MXN",
    "items_total_amount": 42000,
    "sub_total": 42000,
    "total_tax_amount": 6720,
    "total_amount": 48720,
    "items": [
      {
        "id": "show-20261115-1930-screen-05",
        "sku": "ADULT-2D",
        "name": "Two adult tickets",
        "description": "Evening screening · Screen 5",
        "options": "Seats E10 and E11",
        "quantity": 2,
        "category": "movie_tickets",
        "type": "event",
        "taxable": true,
        "unit_price": {
          "amount": 15000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "total_amount": {
          "amount": 30000,
          "original_amount": 30000,
          "currency": "MXN",
          "currency_symbol": "$",
          "total_discount": 0
        },
        "tax_amount": {
          "amount": 4800,
          "currency": "MXN",
          "currency_symbol": "$"
        }
      },
      {
        "id": "concession-combo-02",
        "sku": "POPCORN-COMBO-L",
        "name": "Large popcorn combo",
        "quantity": 1,
        "category": "concessions",
        "taxable": true,
        "unit_price": {
          "amount": 12000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "total_amount": {
          "amount": 12000,
          "original_amount": 12000,
          "currency": "MXN",
          "currency_symbol": "$",
          "total_discount": 0
        },
        "tax_amount": {
          "amount": 1920,
          "currency": "MXN",
          "currency_symbol": "$"
        }
      }
    ],
    "shipping_options": {
      "type": "pickup",
      "method": "digital_ticket",
      "requires_shipping": false,
      "details": {
        "store_id": "mx-polanco-12",
        "store_name": "Polanco Cinema",
        "address": "Avenida Ejército Nacional 843, Ciudad de México",
        "address_coordinates": {
          "lat": 19.4391,
          "lng": -99.2019
        },
        "contact": {
          "name": "Guest services",
          "phone": "+525500000000"
        },
        "event_date": "2026-11-15T19:30:00-06:00",
        "event_seating": "E10, E11",
        "event_city": "Ciudad de México",
        "event_country_code": "MX",
        "recipient_email": "alex@example.com"
      }
    },
    "payer_info": {
      "email": "alex@example.com"
    },
    "expires_at": "2026-11-15T19:15:00-06:00",
    "metadata": {
      "vertical": "cinema",
      "movie_id": "movie-4408",
      "format": "2D"
    },
    "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
Proiezione	`event_date`, identificatori del film e della sede
Sede	`store_id`, `store_name`, indirizzo, città, paese e coordinate
Posti a sedere	`event_seating` e articolo del biglietto `options`
Consegna del biglietto	`recipient_email` e informazioni di contatto del pagatore
Servizi di ristorazione	Separati `items[]` con il proprio SKU, quantità, tasse e totale

Controllo di avvio#

Mantieni l'ID dello spettacolo cinematografico e la prenotazione dei posti stabili durante il tentativo di pagamento.
Allinea la data di scadenza dell'ordine alla durata di mantenimento del sistema di prenotazione.
Separa le linee di biglietti e concessioni per le esigenze di tassazione, evasione, rimborso e reporting.
Invia il destinatario corretto del biglietto quando acquirente e spettatore sono diversi.
Testa scenari di scadenza della prenotazione, tentativi di ripristino, rimborso parziale, screening annullato e ritardo del webhook.

Continua con Flusso e stati di pagamento e Webhook.