Saltar al contenido principal
En esta página

Mantener las entradas, asientos asignados, comida y pago en un ciclo de vida de pedido. DEUNA permite a los equipos de cine vender la visita completa, manteniendo el contexto del evento necesario para emitir entradas y apoyar a los clientes.

Payload completo de pedido de cine#

Los detalles del evento se encuentran en shipping_options.details, mientras que las entradas y la comida permanecen como elementos de línea separados para operaciones y conciliación.

Payload completo de la orden

Cine

Función, sede, asientos asignados, entrega de entradas y concesiones en un solo ciclo de orden.

itemsshipping_options.details.event_dateevent_seatingrecipient_email
Cuerpo de la solicitudJSON
{
  "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"
    }
  }
}

Modela el contexto de negocio#

RequisitoCampos de orden
Proyecciónevent_date, identificadores de tienda y película
Salastore_id, store_name, dirección, ciudad, país y coordenadas
Asientosevent_seating y artículo de entrada options
Entrega de entradasrecipient_email y datos de contacto del comprador
ComidaSeparada items[] con su propio SKU, cantidad, tasa y total

Lista de verificación de producción#

  • Mantener el ID de la proyección y la reserva de asientos estables a lo largo del intento de pago.
  • Hacer que la fecha de expiración del pedido sea coherente con la duración de la reserva.
  • Separar las líneas de entrada y comida para fines fiscales, de cumplimiento, de reembolso y de informes.
  • Enviar el destinatario de la entrada correcto cuando el comprador y el asistente son diferentes.
  • Probar los escenarios de expiración de la reserva, reintento, reembolso parcial, proyección cancelada y retraso de webhook.

Continuar con Flujo y estados de pago y Ganchos web.