POST/v1/flights/order/pending/cancel/:gdsprovider/:orderId

Crear cancelación pendiente de vuelo

Inicia un flujo de cancelación pendiente para revisar reembolso, penalidades o confirmación del proveedor antes de cancelar definitivamente.

Compartir
POST/v1/flights/order/pending/cancel/:gdsprovider/:orderId

Consola API

Pruébalo

Envía una petición real al entorno sandbox e inspecciona la respuesta.

Credenciales

Inicia sesión para elegir entre tus API keys guardadas en vez de pegarlas.

Parámetros de ruta

2 campos

Proveedor GDS

Sistema de distribución global usado para obtener contenido de vuelos. Selecciona 0 para el proveedor predeterminado.

ID de orden

Identificador de la orden devuelta al crear la reserva.

Petición cURL

cURL
bash
curl -X POST 'https://api.sandbox.travelandz.com/v1/flights/order/pending/cancel/0/:orderId' \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE'

Añade tus credenciales para enviar una petición.

Respuesta

Pulsa «¡Pruébalo!» para enviar una petición y ver la respuesta aquí.

Inicia un flujo de cancelación pendiente para revisar reembolso, penalidades o confirmación del proveedor antes de cancelar definitivamente.

Endpoint

MétodoRutaAuth
POST/v1/flights/order/pending/cancel/:gdsprovider/:orderIdAPI key requerida
Headers obligatorios:
HeaderDescripción
AuthorizationBearer <secret_key>. El secret se muestra una sola vez al crear la credencial.
X-Travelandz-Id<public_key>:<profile_code>. El profile_code es el codigo de Developer Profile con prefijo dp_ que ves en el dashboard. Esto vincula la peticion con un perfil y una credencial.
Content-TypeUsa application/json para peticiones con cuerpo.

Esquema de parámetros de la petición

gdsprovider
numberSí
Solo gdsprovider "0" soporta este flujo
orderId
stringSí

Cuerpo de la petición

No requiere cuerpo de petición.

Respuesta exitosa

Devuelve the pending cancellation id, contexto de reembolso, fechas, creditos de aerolinea y liveMode.

Esquema del cuerpo de la respuesta

cancellationId
stringSí
orderId
stringSí
refund
objectSí
refundto
stringSí
refundamount
stringSí
refundcurrency
stringSí
createdAt
string
Format: ISO 8601
Sí
expiresAt
string
Format: ISO 8601
Sí
confirmedAt
string
Format: ISO 8601
Nulable
airlineCredits
arraySí
airlineCredits[]passengerId
stringSí
airlineCredits[]issuedOn
string
Format: ISO 8601
Sí
airlineCredits[]id
stringSí
airlineCredits[]creditName
stringSí
airlineCredits[]creditCurrency
stringSí
airlineCredits[]creditCode
stringSí
airlineCredits[]creditAmount
stringSí
liveMode
booleanSí
True cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.

Notas operativas

Solo gdsprovider "0" soporta este flujo. Travelandz devuelve el payload publico de cancelacion adaptado y persiste internamente la cancelacion pendiente.

Ejemplo

bash
bash
curl -X POST https://api.sandbox.travelandz.com/v1/flights/order/pending/cancel/0/order_123 \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"

Respuestas

CódigoDescripción
200Cancelacion pendiente de vuelo creada correctamente.
400Solicitud inválida: payload no válido.
401No autorizado: credenciales inválidas o ausentes.
403Prohibido: credenciales inválidas.
500Error interno del servidor

200 Cuerpo de la respuesta

Tipo de contenido: application/json

json
json
{
  "cancellationId": "ore_0000B7awtcMBc20FXigs1Z",
  "orderId": "ord_0000B7aw6DtypHDaOdA5hV",
  "refund": {
    "to": "balance",
    "amount": "221.89",
    "currency": "EUR"
  },
  "createdAt": "2026-06-22T15:07:18.622Z",
  "expiresAt": "2026-06-22T16:07:18.000Z",
  "confirmedAt": null,
  "airlineCredits": [],
  "liveMode": false
}