Gopaxo
API partenaires Gopaxo pour la recherche, la réservation, l'annulation et les préventes de billets train et bus

API partenaires

L'API train et bus européenne pour vos partenaires

Une API REST unique pour rechercher, réserver, annuler et accéder aux préventes de toutes les compagnies de train et de bus que nous distribuons. Sandbox gratuite, documentation OpenAPI, support partenaires dédié.

Fonctionnalités

Tout le parcours billet, exposé par API

L'API partenaires Gopaxo couvre les quatre étapes critiques du cycle de vie d'un billet train ou bus, pour vous éviter d'intégrer chaque compagnie séparément.

Recherche multimodale

Interrogez en une seule requête tous les opérateurs train et bus desservant un trajet : tarifs, durées, escales, classes, cartes de réduction et CO₂ retournés en temps réel.

Réservation et émission

Réservez et émettez les billets directement depuis l'API : voyageurs nominatifs, places assises, options bagage, cartes de réduction, paiement sécurisé via votre PSP ou le nôtre.

Annulation et remboursement

Annulez un billet en quelques appels, déclenchez le remboursement selon les CGV de l'opérateur. Statuts détaillés, raisons d'échec normalisées, journal d'événements traçable.

Préventes anticipées

Accédez aux ouvertures de ventes et aux préventes des opérateurs (TGV, Eurostar, Trenitalia, FlixBus…) dès leur disponibilité. Webhooks pour notifier vos utilisateurs en temps réel.

Couverture transporteurs

Toutes les compagnies de train et de bus que nous distribuons

L'API Gopaxo expose l'intégralité de l'inventaire que nous opérons côté public : grands opérateurs ferroviaires, low-cost et autocaristes longue distance, dans 160 pays.

Compagnies de train

Tous les opérateurs ferroviaires majeurs et la plupart des opérateurs régionaux européens sont accessibles depuis un seul endpoint.

  • SNCF
  • OUIGO
  • Eurostar
  • Thalys
  • Trenitalia
  • Italo
  • Renfe
  • Deutsche Bahn
  • ÖBB
  • SBB
  • NS
  • SNCB
  • CFL
  • PKP
  • ČD
  • MÁV
  • CP
  • DSB
  • VR
  • + régionaux

Compagnies de bus et autocar

Les principaux autocaristes longue distance européens sont disponibles via la même API que les trains.

  • FlixBus
  • BlaBlaCar Bus
  • Alsa
  • Megabus
  • National Express
  • Eurolines
  • RegioJet
  • Student Agency
  • Marino Bus
  • Itabus
  • Westbahn
  • Vy Buss
  • Onnibus
  • + régionaux

Caractéristiques techniques

Pensée pour les équipes produit et plateforme

Une API REST moderne, documentée et observable, prête à passer en revue par votre équipe sécurité et architecture.

REST + JSON, OpenAPI 3

Endpoints REST documentés en OpenAPI 3, schémas typés, exemples de payloads pour chaque parcours. Compatible avec tous les générateurs de SDK du marché.

OAuth 2 et clés API

Authentification OAuth 2 client credentials ou clés API rotatives selon votre stack. Scopes granulaire par parcours (search, book, cancel) et par environnement.

Webhooks événementiels

Notifications signées (HMAC) sur les événements clés : confirmation de réservation, changement d'horaire, annulation opérateur, remboursement émis. Réessais automatiques.

Sandbox gratuite

Environnement de test iso-fonctionnel à la production, avec données de test stables. Aucune limite d'appels, pas d'engagement, accès partagé à toute votre équipe.

SLA 99,9 % et observabilité

Disponibilité contractuelle 99,9 %, statuspage partagée, p50 < 800 ms sur la recherche. Logs et traces poussables vers votre stack (Datadog, Grafana, Sentry…).

Documentation et SDKs

Portail développeur complet, exemples curl et Postman, guides d'intégration par cas d'usage. SDKs officiels TypeScript et Python, communauté open-source sur GitHub.

Onboarding

Quatre étapes pour passer du sandbox à la prod

Notre processus d'onboarding est conçu pour livrer un POC fonctionnel rapidement, sans sacrifier la qualité de mise en production.

  1. 1. Vous envoyez le formulaire

    Décrivez votre cas d'usage, votre stack, votre volumétrie cible et votre calendrier idéal. 3 minutes suffisent.

  2. 2. Réponse en 24h ouvrées

    Un membre de l'équipe partenaires vous recontacte pour qualifier le besoin et planifier un cadrage technique de 30 minutes.

  3. 3. Accès sandbox

    Token sandbox, documentation et exemples envoyés dans la foulée. Vous pouvez commencer à coder immédiatement, sans engagement.

  4. 4. Contractualisation et go-live

    Une fois le POC validé, on contractualise (commission ou abonnement) puis on bascule en prod avec un rollout progressif et un suivi conjoint.

Questions API

Les questions techniques les plus posées

Les questions revues avec nos partenaires lors du cadrage technique et du test de la sandbox.

L'API permet-elle vraiment la réservation et l'émission de billets ?

Oui. L'API gère le parcours complet : recherche, sélection de l'offre, création des voyageurs nominatifs, paiement, émission du billet (PDF, code-barres, Apple Wallet / Google Wallet selon l'opérateur) et envoi des justificatifs.

Comment fonctionne l'annulation et le remboursement ?

Chaque billet émis peut être annulé via un endpoint dédié. Les règles d'annulation (délai, montant remboursable, frais) sont retournées par l'API en amont de la confirmation. Le remboursement est déclenché automatiquement selon les CGV de l'opérateur et le moyen de paiement initial.

Avez-vous accès aux préventes des opérateurs ?

Oui. Notre moteur intègre les calendriers d'ouverture de vente des principaux opérateurs (TGV, Eurostar, Trenitalia, Renfe, FlixBus). Vous pouvez interroger l'API à l'avance et recevoir un webhook dès que les billets deviennent disponibles.

Quel format ? REST, GraphQL, gRPC ?

REST + JSON, avec une spec OpenAPI 3 disponible en téléchargement. C'est le format le mieux supporté par les outils d'intégration partenaires (Postman, génération de SDKs, API gateways). GraphQL n'est pas exposé publiquement.

Quelle authentification ?

OAuth 2 client credentials par défaut pour les intégrations server-to-server, avec rotation des secrets côté partenaire. Des clés API longue durée restent possibles pour des cas spécifiques (CI, edge functions). Toutes les requêtes doivent être en TLS 1.2+.

Y a-t-il une sandbox ? Est-elle gratuite ?

Oui, la sandbox est 100 % gratuite et sans engagement. Elle expose les mêmes endpoints que la production, sur un jeu de données de test stable. Vous pouvez la garder ouverte aussi longtemps que nécessaire pour intégrer, tester et démarcher en interne.

Quels sont les délais d'accès ?

Sous 24 heures ouvrées pour le premier retour de l'équipe partenaires. Le token sandbox est généralement délivré dans les 48 heures ouvrées suivant le cadrage technique.

Comment êtes-vous facturés en prod ?

Trois modèles disponibles : commission sur ventes (le plus courant), abonnement plate-forme + commission réduite, ou licence dédiée pour les très gros volumes. Aucune facturation tant que vous restez en sandbox.

Êtes-vous conformes RGPD et PCI-DSS ?

Oui. Données personnelles hébergées dans l'Union européenne et traitées sous contrat de sous-traitance RGPD. Le flux de paiement passe par un PSP certifié PCI-DSS niveau 1 ; Gopaxo ne stocke jamais les données carte en clair.

Demander un accès à l'API partenaires Gopaxo

Décrivez votre projet — un membre de l'équipe partenaires vous répond sous 24h ouvrées avec les prochaines étapes et un accès sandbox.

Vos données sont utilisées uniquement pour traiter votre demande d'accès API. Aucun usage marketing, conformément au RGPD.