Pular para o conteúdo principal
Nesta página

Mantenha os ingressos, assentos atribuídos, concessões e pagamento em um ciclo de vida único. A DEUNA permite que as equipes do cinema vendam a visita completa, mantendo o contexto do evento necessário para emitir ingressos e atender aos clientes.

Payload completo de pedido para cinema#

Os detalhes do evento estão em shipping_options.details, enquanto os ingressos e as concessões permanecem como itens de linha distintos para operações e reconciliação.

Payload completo do pedido

Cinema

Sessão, local, assentos marcados, entrega de ingressos e concessões em um único ciclo de pedido.

itemsshipping_options.details.event_dateevent_seatingrecipient_email
Corpo da solicitaçãoJSON
{
  "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"
    }
  }
}

Modelar o contexto de negócios#

RequisitoCampos de pedido
Exibiçãoevent_date, identificadores de cinema e filme
Localstore_id, store_name, endereço, cidade, país e coordenadas
Assentosevent_seating e item de ingresso options
Entrega de ingressorecipient_email e contato do pagador
ConcessõesSeparadas items[] com SKU, quantidade, impostos e total próprios

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

  • Mantenha o ID da exibição do cinema e a reserva de assentos estáveis ​​durante a tentativa de pagamento.
  • Garanta que o prazo de validade do pedido seja consistente com a duração da reserva.
  • Separe as linhas de ingresso e concessão para fins de impostos, entrega, reembolso e relatórios.
  • Envie o destinatário do ingresso correto quando o comprador e o participante forem diferentes.
  • Teste cenários de expiração, redefinição, reembolso parcial, exibição cancelada e atraso do webhook.

Continuar com Fluxo e status de pagamento e Webhooks.