GET/v1/trains/order/:gdsprovider/:orderId/refund

Consultar el estado del reembolso de tren

Consulta las operaciones de reembolso y el estado de cada ítem.

Compartir

Consulta las operaciones de reembolso y el estado de cada ítem.

Autenticación y headers

HeaderDescripción
AuthorizationBearer <secret_key>. Conserva el secret en el servidor y nunca lo escribas en logs del cliente.
X-Travelandz-Id<public_key>:<profile_code>, donde el profile code persistido tiene el formato dp_<12 alfanuméricos>.
Content-Typeapplication/json para peticiones con body JSON.

Petición

Parámetros de path: gdsprovider actualmente es 0; orderId viene de la creación de la orden.

Schema de parámetros

gdsprovider
enum
0
Sí
Currently 0
orderId
stringSí
Order id returned by order creation.

Respuesta exitosa

Devuelve refunds[] con id, estado, fechas, importe total reembolsado y estados por ítem. Un reembolso puede ser success, pending o error.

Schema de respuesta

refunds
arraySí
refunds[]id
stringSí
refunds[]state
enum
successpendingerror
Sí
refunds[]createdAt
string
Formato: ISO 8601
Sí
refunds[]totalRefunded
objectSí
refunds[]totalRefundedamount
numberSí
refunds[]totalRefundedcurrency
stringSí
refunds[]items
arraySí
refunds[]items[]id
stringSí
refunds[]items[]state
enum
successpendingerror
Sí
refunds[]items[]amount
objectSí
refunds[]items[]amountamount
numberSí
refunds[]items[]amountcurrency
stringSí
refunds[]items[]parts
arraySí
refunds[]items[]parts[]segments
arraySí
refunds[]items[]parts[]segments[]departureAt
string
Formato: ISO 8601
Sí
refunds[]items[]parts[]segments[]arrivalAt
string
Formato: ISO 8601
Sí
refunds[]items[]parts[]segments[]durationInMinutes
numberSí
refunds[]items[]parts[]segments[]transport
enum
trainbusferry
Sí
refunds[]items[]parts[]segments[]identifier
stringSí

Errores

  • 400 por validación o campos desconocidos.
  • 401 o 403 por credenciales API inválidas.
  • 500 internal_communication_error o unknown_error por fallos del proveedor.
  • order_not_found cuando la orden no existe.

Notas de uso

Usa este endpoint después de solicitar un reembolso para distinguir ítems completados, pendientes y fallidos.

Ejemplo cURL

bash
bash
curl --request GET \
  --url "https://api.sandbox.travelandz.com/v1/trains/order/0/order_123/refund" \
  --header "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  --header "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"