Pagos y pedidos de aerolíneas

En esta página

Payload completo de pedido de aerolínea
Modela el contexto de negocio
Lista de verificación de producción

DEUNA trata los datos de reserva de aerolíneas como parte del pedido, no como un conjunto de datos opaco. Conserva el contexto comercial y de viaje utilizado por los proveedores de pago, los controles de fraude, la conciliación y las operaciones de clientes.

Contexto de reservaIncluye el PNR, el número de billete electrónico, los códigos de aerolínea, el sistema de reservas y la agencia emisora.Detalles del itinerarioRepresenta cada origen, destino, transportista, vuelo, asiento, base de tarifa y clase de servicio.Servicios adicionalesAsocia equipaje y otros servicios de pago al elemento de reserva y al billete correspondiente.

Payload completo de pedido de aerolínea#

Uso AIRLINE_ORDER y incluye airline_information.booking_items. El ejemplo refleja el modelo de aerolínea compatible con los servicios de pedido y pago.

Payload completo de la orden

Aerolíneas

PNR, pasajero, boleto, itinerario, tarifa, impuestos y servicios adicionales en una orden aérea tipada.

Abrir guía de la industria

airline_informationbooking_itemslegsancillaries

Cuerpo de la solicitudJSON

{
  "order_type": "AIRLINE_ORDER",
  "order": {
    "order_id": "pnr-N7K4Q2",
    "store_code": "web-eu",
    "currency": "EUR",
    "items_total_amount": 52000,
    "sub_total": 52000,
    "total_tax_amount": 9200,
    "total_amount": 61200,
    "items": [
      {
        "id": "ticket-0741234567890",
        "name": "Madrid to Paris",
        "description": "Economy Flex airfare with one checked bag",
        "quantity": 1,
        "category": "airfare",
        "taxable": true,
        "unit_price": {
          "amount": 52000,
          "currency": "EUR",
          "currency_symbol": "€"
        },
        "total_amount": {
          "amount": 52000,
          "original_amount": 52000,
          "currency": "EUR",
          "currency_symbol": "€",
          "total_discount": 0
        },
        "tax_amount": {
          "amount": 9200,
          "currency": "EUR",
          "currency_symbol": "€"
        }
      }
    ],
    "airline_information": {
      "booking_items": [
        {
          "pnr": "N7K4Q2",
          "ticket_number": "0741234567890",
          "e_ticket": true,
          "airline_3_digit_code": "074",
          "airline_iata_designator": "UX",
          "reservation_system_code": "AMADEUS",
          "ticketing_travel_agency": {
            "iata_code": "91234567",
            "name": "DEUNA Travel",
            "agency_invoice_number": "INV-2026-00421"
          },
          "passenger": {
            "user_id": "traveler-8821",
            "first_name": "Alex",
            "middle_name": "",
            "last_name": "Morgan",
            "title": "Mx",
            "date_of_birth": "1990-06-25",
            "document_type": "passport",
            "identity_document_number": "PA1234567",
            "document_number": "PA1234567",
            "email": "alex@example.com",
            "phone": "+34600000000",
            "frequent_flyer_code": "UX008821",
            "country_code": "ES",
            "type": "ADT"
          },
          "legs": [
            {
              "origin": {
                "iata_code": "MAD",
                "date": "2026-11-14",
                "time": "09:10",
                "city": "Madrid",
                "country_code": "ES"
              },
              "destination": {
                "iata_code": "ORY",
                "date": "2026-11-14",
                "time": "11:05",
                "city": "Paris",
                "country_code": "FR"
              },
              "carrier_code": "UX",
              "carrier_name": "Air Europa",
              "flight_number": "UX1027",
              "seat_location": "12A",
              "fare_basis_code": "YFLEX",
              "stopover_code": "O",
              "sub_total_amount": 48500,
              "tax_amount": 9200,
              "total_amount": 57700,
              "service_class": "Y",
              "airport_tax_amount": 4700
            }
          ],
          "ancillaries": [
            {
              "type": "BAGGAGE",
              "ticket_number": "0741234567890",
              "total_amount": 3500,
              "service_category": "baggage",
              "description": "One checked bag",
              "category_code": "BG",
              "sub_category_code": "23K",
              "fee_code": "0CC",
              "unit_price": 3500
            }
          ]
        }
      ]
    },
    "payer_info": {
      "email": "alex@example.com",
      "date_of_birth": "1990-06-25T00:00:00Z"
    },
    "description": "N7K4Q2 · MAD–ORY",
    "statement_descriptor": "DEUNA TRAVEL",
    "channel_type": "desktop_web",
    "metadata": {
      "vertical": "airline",
      "sales_channel": "direct",
      "loyalty_tier": "gold"
    },
    "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
Reserva y billete	`pnr`, `ticket_number`, `e_ticket`, `reservation_system_code`
Pasajero	`passenger` identificación, contacto, tipo y campos de frecuente viajero
Vuelo	`legs[].origin`, `destination`, `carrier_code`, `flight_number`, `service_class`
Tarifa y impuestos	Leg, subtotal del pedido, impuesto, impuesto aeroportuario y montos totales
Servicios adicionales	`ancillaries[]` tipo, categoría de servicio, billete, código de tarifa y monto

Lista de verificación de producción#

Mapea uno booking_item por relación entre pasajero y billete utilizada por tu sistema de reservas.
Utiliza los designadores de aeropuerto y aerolínea de IATA de forma consistente.
Concilia los totales de pedido, leg, impuesto, servicios adicionales y totales en unidades monetarias menores.
Mantén los datos personales identificables del pasajero limitados a los campos requeridos por el flujo.
Prueba escenarios de autorización, 3DS, captura diferida, cancelación, reembolso e itinerarios modificados.

Continuar con Autenticación 3DS, flujos de captura y reembolsoy Procesar el pago de un pedido.