Crear orden de vuelo

Crea una reserva instantánea o una orden en hold desde una oferta seleccionada. Las reservas públicas resuelven el precio interno desde offerId o desde la oferta trackeada.

Endpoint

Esquema de parámetros de la petición

Esquema del cuerpo de la petición

Respuesta exitosa

Devuelve identificadores de orden, estado y payload de reserva del proveedor.

Esquema del cuerpo de la respuesta

Notas operativas

• La reserva publica siempre requiere un snapshot trackeado de la oferta publica seleccionada para el mismo profile, gdsprovider y offerId.
• passengers[].id is the passenger id from the tracked offer, not an internal user identifier.
• passengers[].id y passengers[].type deben coincidir exactamente con los pasajeros de la oferta trackeada. Se rechazan ids vacios, duplicados, pasajeros faltantes, pasajeros extra o tipos que no coinciden.
• Las ofertas publicas de Mystifly generan ids internos de pasajero como mystifly_pax_1, mystifly_pax_2, etc. Reutiliza esos ids exactamente como los devuelve la oferta.
• No envies identificadores internos de usuario; no forman parte del contrato publico de reserva.
• No envies originalPrice en reservas publicas. La API resuelve precio y moneda internos desde offerId o desde la oferta trackeada. Si se envia originalPrice, la validacion publica rechaza la peticion por ser un campo no permitido.
• Envia identity_documents[] cuando la oferta o el endpoint required-fields indiquen que se requieren documentos de identidad.
• type=hold and holdId only apply when the selected booking flow supports hold payment.
• totalSegments[] solo es requerido cuando el flujo seleccionado necesita metadata de segmentos. Construyelo desde cada item de offer.slices[].segments[].

Mapeo de required-fields a create-order

Los flags genericos age, address, city, postalCode y documentIssuedAt actualmente no mapean a campos publicos explicitos de reserva.

Payloads anidados de pasajero

{
  "identity_documents": [
    {
      "type": "passport",
      "unique_identifier": "X1234567",
      "issuing_country_code": "ES",
      "expires_on": "2030-12-31"
    }
  ],
  "loyaltyProgrammeAccounts": [
    {
      "airlineIataCode": "BA",
      "accountNumber": "123456789"
    }
  ]
}

Ejemplo de totalSegments

[
  {
    "originCode": "MAD",
    "destinationCode": "BCN",
    "flightNumber": "1234",
    "departureDate": "2026-08-20T08:15:00"
  }
]

Ejemplo

curl -X POST https://api.sandbox.travelandz.com/v1/flights/order/0/offer_123 \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '{"currency":"EUR","type":"instant","passengers":[{"id":"pas_0001","type":"adult","title":"mr","phone_number":"+34612345678","firstName":"John","lastName":"Doe","gender":"m","email":"john.doe@example.com","bornDate":"1990-01-15","country":"ES"}]}'

Cuerpo de la petición - Ejemplo

{
  "currency": "EUR",
  "passengers": [
    {
      "id": "pas_0000B7VCW4ca7emwcBOyUf",
      "type": "adult",
      "title": "mr",
      "phone_number": "+573128837058",
      "firstName": "Alejandro",
      "lastName": "Toledo",
      "gender": "m",
      "email": "jairotoledo2003@gmail.com",
      "bornDate": "2003-08-14"
    }
  ],
  "type": "instant"
}

Respuestas

200 Cuerpo de la respuesta

Tipo de contenido: application/json

{
  "orderId": "ord_0000B7VCdoZtPDdnjqCYIe",
  "liveMode": false
}