Búsqueda multimodal
Consulte en una sola petición todos los operadores de tren y bus que cubren un trayecto: tarifas, duraciones, escalas, clases, tarjetas de descuento y CO₂ devueltos en tiempo real.
API de partners
La API de tren y bus europea para sus partners
Una API REST única para buscar, reservar, cancelar y acceder a las preventas de todas las compañías de tren y bus que distribuimos. Sandbox gratuita, documentación OpenAPI, soporte dedicado a partners.
Funcionalidades
Todo el recorrido del billete, expuesto vía API
La API de partners Gopaxo cubre las cuatro etapas críticas del ciclo de vida de un billete de tren o bus, para evitarle integrar cada compañía por separado.
Reserva y emisión
Reserve y emita los billetes directamente desde la API: viajeros nominativos, asientos reservados, opciones de equipaje, tarjetas de descuento, pago seguro a través de su PSP o el nuestro.
Cancelación y reembolso
Cancele un billete en unas pocas llamadas, active el reembolso según las condiciones del operador. Estados detallados, motivos de fallo normalizados, registro de eventos trazable.
Preventas anticipadas
Acceda a las aperturas de ventas y a las preventas de los operadores (TGV, Eurostar, Trenitalia, FlixBus…) tan pronto estén disponibles. Webhooks para notificar a sus usuarios en tiempo real.
Cobertura de transportistas
Todas las compañías de tren y bus que distribuimos
La API Gopaxo expone todo el inventario que operamos en el lado público: grandes operadores ferroviarios, low-cost y autocaristas de larga distancia, en 160 países.
Compañías de tren
Todos los operadores ferroviarios principales y la mayoría de los operadores regionales europeos están accesibles desde un único endpoint.
- SNCF
- OUIGO
- Eurostar
- Thalys
- Trenitalia
- Italo
- Renfe
- Deutsche Bahn
- ÖBB
- SBB
- NS
- SNCB
- CFL
- PKP
- ČD
- MÁV
- CP
- DSB
- VR
- + regionales
Compañías de bus y autocar
Los principales autocaristas de larga distancia europeos están disponibles a través de la misma API que los trenes.
- FlixBus
- BlaBlaCar Bus
- Alsa
- Megabus
- National Express
- Eurolines
- RegioJet
- Student Agency
- Marino Bus
- Itabus
- Westbahn
- Vy Buss
- Onnibus
- + regionales
Características técnicas
Pensada para los equipos de producto y plataforma
Una API REST moderna, documentada y observable, lista para ser revisada por su equipo de seguridad y arquitectura.
REST + JSON, OpenAPI 3
Endpoints REST documentados en OpenAPI 3, esquemas tipados, ejemplos de payloads para cada recorrido. Compatible con todos los generadores de SDK del mercado.
OAuth 2 y claves API
Autenticación OAuth 2 client credentials o claves API rotativas según su stack. Scopes granulares por recorrido (search, book, cancel) y por entorno.
Webhooks por eventos
Notificaciones firmadas (HMAC) sobre los eventos clave: confirmación de reserva, cambio de horario, cancelación del operador, reembolso emitido. Reintentos automáticos.
Sandbox gratuita
Entorno de prueba iso-funcional a producción, con datos de test estables. Sin límite de llamadas, sin compromiso, acceso compartido para todo su equipo.
SLA 99,9 % y observabilidad
Disponibilidad contractual del 99,9 %, statuspage compartida, p50 < 800 ms en la búsqueda. Logs y trazas exportables a su stack (Datadog, Grafana, Sentry…).
Documentación y SDKs
Portal de desarrollador completo, ejemplos curl y Postman, guías de integración por caso de uso. SDKs oficiales TypeScript y Python, comunidad open-source en GitHub.
Onboarding
Cuatro etapas para pasar del sandbox a producción
Nuestro proceso de onboarding está diseñado para entregar un POC funcional rápidamente, sin sacrificar la calidad de la puesta en producción.
1. Usted envía el formulario
Describa su caso de uso, su stack, su volumetría objetivo y su calendario ideal. Bastan 3 minutos.
2. Respuesta en 24 horas laborables
Un miembro del equipo de partners se pone en contacto con usted para cualificar la necesidad y planificar un encuadre técnico de 30 minutos.
3. Acceso a sandbox
Token sandbox, documentación y ejemplos enviados a continuación. Puede empezar a programar inmediatamente, sin compromiso.
4. Contractualización y go-live
Una vez validado el POC, se contractualiza (comisión o suscripción) y se pasa a producción con un rollout progresivo y un seguimiento conjunto.
Preguntas API
Las preguntas técnicas más frecuentes
Las preguntas revisadas con nuestros partners durante el encuadre técnico y la prueba del sandbox.
¿La API permite realmente la reserva y la emisión de billetes?
Sí. La API gestiona el recorrido completo: búsqueda, selección de la oferta, creación de los viajeros nominativos, pago, emisión del billete (PDF, código de barras, Apple Wallet / Google Wallet según el operador) y envío de los justificantes.
¿Cómo funciona la cancelación y el reembolso?
Cada billete emitido puede cancelarse a través de un endpoint dedicado. Las reglas de cancelación (plazo, importe reembolsable, gastos) son devueltas por la API antes de la confirmación. El reembolso se activa automáticamente según las condiciones del operador y el medio de pago inicial.
¿Tienen acceso a las preventas de los operadores?
Sí. Nuestro motor integra los calendarios de apertura de venta de los principales operadores (TGV, Eurostar, Trenitalia, Renfe, FlixBus). Puede consultar la API por adelantado y recibir un webhook tan pronto como los billetes estén disponibles.
¿Qué formato? ¿REST, GraphQL, gRPC?
REST + JSON, con una spec OpenAPI 3 disponible para descargar. Es el formato mejor soportado por las herramientas de integración de partners (Postman, generación de SDKs, API gateways). GraphQL no está expuesto públicamente.
¿Qué autenticación?
OAuth 2 client credentials por defecto para las integraciones server-to-server, con rotación de los secretos del lado del partner. Las claves API de larga duración siguen siendo posibles para casos específicos (CI, edge functions). Todas las peticiones deben ser en TLS 1.2+.
¿Hay una sandbox? ¿Es gratuita?
Sí, la sandbox es 100 % gratuita y sin compromiso. Expone los mismos endpoints que producción, sobre un conjunto de datos de test estable. Puede mantenerla abierta tanto tiempo como sea necesario para integrar, probar y prospectar internamente.
¿Cuáles son los plazos de acceso?
En 24 horas laborables para la primera respuesta del equipo de partners. El token sandbox se entrega generalmente en las 48 horas laborables siguientes al encuadre técnico.
¿Cómo se factura en producción?
Tres modelos disponibles: comisión sobre ventas (el más común), suscripción a la plataforma + comisión reducida, o licencia dedicada para volúmenes muy grandes. Sin facturación mientras se mantenga en sandbox.
¿Son conformes al RGPD y PCI-DSS?
Sí. Datos personales alojados en la Unión Europea y tratados bajo contrato de subencargo RGPD. El flujo de pago pasa por un PSP certificado PCI-DSS nivel 1; Gopaxo nunca almacena los datos de tarjeta en claro.