Multimodale Suche
Fragen Sie mit einer einzigen Anfrage alle Zug- und Busbetreiber einer Strecke ab: Preise, Reisezeiten, Umsteigeverbindungen, Klassen, Ermäßigungskarten und CO₂ in Echtzeit zurückgeliefert.
Partner-API
Die europäische Zug- und Bus-API für Ihre Partner
Eine einzige REST-API, um bei allen von uns vertriebenen Zug- und Busgesellschaften zu suchen, zu buchen, zu stornieren und auf Vorverkäufe zuzugreifen. Kostenlose Sandbox, OpenAPI-Dokumentation, dedizierter Partner-Support.
Funktionen
Der gesamte Ticketprozess per API verfügbar
Die Gopaxo Partner-API deckt die vier kritischen Phasen des Lebenszyklus eines Zug- oder Bustickets ab, damit Sie nicht jede Gesellschaft einzeln integrieren müssen.
Buchung und Ausstellung
Buchen und stellen Sie Tickets direkt über die API aus: namentliche Reisende, Sitzplatzwahl, Gepäckoptionen, Ermäßigungskarten, sichere Zahlung über Ihren oder unseren PSP.
Stornierung und Erstattung
Stornieren Sie ein Ticket mit wenigen Aufrufen und lösen Sie die Erstattung gemäß den AGB des Betreibers aus. Detaillierte Status, normalisierte Fehlerursachen, nachvollziehbares Ereignisprotokoll.
Vorverkäufe
Greifen Sie auf Verkaufsöffnungen und Vorverkäufe der Betreiber (TGV, Eurostar, Trenitalia, FlixBus…) zu, sobald diese verfügbar sind. Webhooks, um Ihre Nutzer in Echtzeit zu benachrichtigen.
Anbieterabdeckung
Alle Zug- und Busgesellschaften, die wir vertreiben
Die Gopaxo-API stellt den gesamten Bestand bereit, den wir auch öffentlich betreiben: große Bahnbetreiber, Low-Cost-Anbieter und Fernbusunternehmen in 160 Ländern.
Eisenbahngesellschaften
Alle wichtigen Bahnbetreiber und die meisten regionalen europäischen Betreiber sind über einen einzigen Endpunkt erreichbar.
- SNCF
- OUIGO
- Eurostar
- Thalys
- Trenitalia
- Italo
- Renfe
- Deutsche Bahn
- ÖBB
- SBB
- NS
- SNCB
- CFL
- PKP
- ČD
- MÁV
- CP
- DSB
- VR
- + regionale
Bus- und Reisebusgesellschaften
Die wichtigsten europäischen Fernbusunternehmen sind über dieselbe API wie die Züge verfügbar.
- FlixBus
- BlaBlaCar Bus
- Alsa
- Megabus
- National Express
- Eurolines
- RegioJet
- Student Agency
- Marino Bus
- Itabus
- Westbahn
- Vy Buss
- Onnibus
- + regionale
Technische Merkmale
Konzipiert für Produkt- und Plattformteams
Eine moderne, dokumentierte und beobachtbare REST-API, bereit für die Prüfung durch Ihr Sicherheits- und Architekturteam.
REST + JSON, OpenAPI 3
REST-Endpunkte dokumentiert in OpenAPI 3, typisierte Schemata, Payload-Beispiele für jeden Ablauf. Kompatibel mit allen gängigen SDK-Generatoren.
OAuth 2 und API-Schlüssel
Authentifizierung über OAuth 2 Client Credentials oder rotierende API-Schlüssel je nach Stack. Granulare Scopes pro Ablauf (search, book, cancel) und pro Umgebung.
Ereignisbasierte Webhooks
Signierte Benachrichtigungen (HMAC) zu Schlüsselereignissen: Buchungsbestätigung, Fahrplanänderung, Stornierung durch Betreiber, ausgestellte Erstattung. Automatische Wiederholungsversuche.
Kostenlose Sandbox
Testumgebung, funktional identisch zur Produktion, mit stabilen Testdaten. Keine Aufruflimits, keine Verpflichtungen, gemeinsamer Zugang für Ihr gesamtes Team.
SLA 99,9 % und Observability
Vertragliche Verfügbarkeit 99,9 %, gemeinsame Statuspage, p50 < 800 ms bei der Suche. Logs und Traces an Ihren Stack weiterleitbar (Datadog, Grafana, Sentry…).
Dokumentation und SDKs
Vollständiges Entwicklerportal, curl- und Postman-Beispiele, Integrationsleitfäden nach Anwendungsfall. Offizielle SDKs für TypeScript und Python, Open-Source-Community auf GitHub.
Onboarding
Vier Schritte von der Sandbox zur Produktion
Unser Onboarding-Prozess ist darauf ausgelegt, schnell einen funktionalen POC zu liefern, ohne die Qualität der Produktivsetzung zu beeinträchtigen.
1. Sie senden das Formular
Beschreiben Sie Ihren Anwendungsfall, Ihren Stack, Ihr Zielvolumen und Ihren Wunschzeitplan. 3 Minuten genügen.
2. Antwort innerhalb von 24 Werktagsstunden
Ein Mitglied des Partnerteams meldet sich bei Ihnen, um den Bedarf zu qualifizieren und ein 30-minütiges technisches Scoping zu planen.
3. Sandbox-Zugang
Sandbox-Token, Dokumentation und Beispiele werden im Anschluss verschickt. Sie können sofort und ohne Verpflichtung mit dem Coden beginnen.
4. Vertragsabschluss und Go-live
Sobald der POC validiert ist, schließen wir den Vertrag ab (Provision oder Abonnement) und wechseln dann mit einem schrittweisen Rollout und gemeinsamem Monitoring in die Produktion.
API-Fragen
Die häufigsten technischen Fragen
Die Fragen, die wir mit unseren Partnern beim technischen Scoping und beim Test der Sandbox durchgehen.
Ermöglicht die API wirklich die Buchung und Ausstellung von Tickets?
Ja. Die API deckt den gesamten Ablauf ab: Suche, Auswahl des Angebots, Anlage der namentlichen Reisenden, Zahlung, Ticketausstellung (PDF, Barcode, Apple Wallet / Google Wallet je nach Betreiber) und Versand der Belege.
Wie funktionieren Stornierung und Erstattung?
Jedes ausgestellte Ticket kann über einen dedizierten Endpunkt storniert werden. Die Stornierungsregeln (Frist, erstattungsfähiger Betrag, Gebühren) werden von der API vor der Bestätigung zurückgegeben. Die Erstattung wird automatisch gemäß den AGB des Betreibers und der ursprünglichen Zahlungsmethode ausgelöst.
Haben Sie Zugang zu den Vorverkäufen der Betreiber?
Ja. Unsere Engine integriert die Verkaufsöffnungs-Kalender der wichtigsten Betreiber (TGV, Eurostar, Trenitalia, Renfe, FlixBus). Sie können die API im Voraus abfragen und erhalten einen Webhook, sobald die Tickets verfügbar werden.
Welches Format? REST, GraphQL, gRPC?
REST + JSON, mit einer zum Download verfügbaren OpenAPI-3-Spezifikation. Es ist das Format, das von Partner-Integrationswerkzeugen am besten unterstützt wird (Postman, SDK-Generierung, API-Gateways). GraphQL wird nicht öffentlich angeboten.
Welche Authentifizierung?
Standardmäßig OAuth 2 Client Credentials für Server-zu-Server-Integrationen, mit Rotation der Secrets auf Partnerseite. Langlebige API-Schlüssel bleiben für besondere Anwendungsfälle (CI, Edge Functions) möglich. Alle Anfragen müssen über TLS 1.2+ erfolgen.
Gibt es eine Sandbox? Ist sie kostenlos?
Ja, die Sandbox ist zu 100 % kostenlos und unverbindlich. Sie stellt dieselben Endpunkte wie die Produktion bereit, mit einem stabilen Testdatensatz. Sie können sie so lange offen halten, wie Sie für die Integration, das Testen und die interne Abstimmung benötigen.
Wie lange dauert es bis zum Zugang?
Innerhalb von 24 Werktagsstunden für die erste Rückmeldung des Partnerteams. Das Sandbox-Token wird in der Regel innerhalb von 48 Werktagsstunden nach dem technischen Scoping ausgehändigt.
Wie werden wir in der Produktion abgerechnet?
Drei verfügbare Modelle: Verkaufsprovision (am häufigsten), Plattform-Abonnement + reduzierte Provision oder dedizierte Lizenz für sehr hohe Volumen. Solange Sie in der Sandbox bleiben, fällt keine Abrechnung an.
Sind Sie DSGVO- und PCI-DSS-konform?
Ja. Personenbezogene Daten werden in der Europäischen Union gehostet und unter einem DSGVO-Auftragsverarbeitungsvertrag verarbeitet. Der Zahlungsfluss läuft über einen PCI-DSS Level-1-zertifizierten PSP; Gopaxo speichert niemals Kartendaten im Klartext.