Gopaxo
Партнёрский API Gopaxo для поиска, бронирования, отмены и предпродаж ж/д и автобусных билетов

Партнёрский API

Европейский ж/д и автобусный API для ваших партнёров

Единый REST API для поиска, бронирования, отмены и доступа к предпродажам всех ж/д и автобусных компаний, которые мы дистрибутируем. Бесплатный sandbox, документация OpenAPI, выделенная поддержка партнёров.

Возможности

Весь путь покупки билета — через API

Партнёрский API Gopaxo покрывает четыре критических этапа жизненного цикла ж/д или автобусного билета, чтобы вам не пришлось интегрировать каждую компанию по отдельности.

Мультимодальный поиск

Одним запросом опросите всех ж/д и автобусных операторов на маршруте: тарифы, длительность, пересадки, классы, карты скидок и CO₂ — в реальном времени.

Бронирование и выпуск

Бронируйте и выпускайте билеты напрямую через API: именные пассажиры, выбор мест, опции багажа, карты скидок, безопасная оплата через ваш PSP или наш.

Отмена и возврат

Отмените билет несколькими вызовами, запустите возврат по условиям оператора. Подробные статусы, нормализованные причины отказа, прослеживаемый журнал событий.

Ранние предпродажи

Получайте доступ к открытиям продаж и предпродажам операторов (TGV, Eurostar, Trenitalia, FlixBus…) как только они становятся доступны. Webhooks для уведомления пользователей в реальном времени.

Покрытие перевозчиков

Все ж/д и автобусные компании, которые мы дистрибутируем

API Gopaxo открывает весь инвентарь, который мы предоставляем на публичной стороне: крупные ж/д операторы, лоукостеры и автобусы дальнего следования в 160 странах.

Железнодорожные компании

Все крупные европейские ж/д операторы и большинство региональных доступны через один эндпоинт.

  • SNCF
  • OUIGO
  • Eurostar
  • Thalys
  • Trenitalia
  • Italo
  • Renfe
  • Deutsche Bahn
  • ÖBB
  • SBB
  • NS
  • SNCB
  • CFL
  • PKP
  • ČD
  • MÁV
  • CP
  • DSB
  • VR
  • + региональные

Автобусные компании

Основные европейские автобусные перевозчики дальнего следования доступны через тот же API, что и поезда.

  • FlixBus
  • BlaBlaCar Bus
  • Alsa
  • Megabus
  • National Express
  • Eurolines
  • RegioJet
  • Student Agency
  • Marino Bus
  • Itabus
  • Westbahn
  • Vy Buss
  • Onnibus
  • + региональные

Технические характеристики

Создан для продуктовых и платформенных команд

Современный REST API, документированный и наблюдаемый, готовый к ревью вашей командой безопасности и архитектуры.

REST + JSON, OpenAPI 3

REST-эндпоинты, документированные в OpenAPI 3, типизированные схемы, примеры payload для каждого сценария. Совместимо со всеми генераторами SDK на рынке.

OAuth 2 и API-ключи

Аутентификация через OAuth 2 client credentials или ротируемые API-ключи в зависимости от вашего стека. Гранулярные scope по сценариям (search, book, cancel) и окружениям.

Событийные webhooks

Подписанные уведомления (HMAC) о ключевых событиях: подтверждение бронирования, изменение расписания, отмена со стороны оператора, выпуск возврата. Автоматические повторы.

Бесплатный sandbox

Тестовое окружение, функционально идентичное продакшену, со стабильными тестовыми данными. Без лимитов вызовов, без обязательств, общий доступ для всей вашей команды.

SLA 99,9 % и наблюдаемость

Договорная доступность 99,9 %, общая статус-страница, p50 < 800 мс на поиск. Логи и трассировки можно push-ить в ваш стек (Datadog, Grafana, Sentry…).

Документация и SDK

Полноценный портал для разработчиков, примеры curl и Postman, руководства по интеграции под сценарии. Официальные SDK на TypeScript и Python, open-source сообщество на GitHub.

Онбординг

Четыре шага от sandbox до продакшена

Наш процесс онбординга рассчитан на быструю поставку рабочего POC без потери качества релиза.

  1. 1. Вы отправляете форму

    Опишите ваш сценарий, стек, целевую нагрузку и желаемый календарь. Достаточно 3 минут.

  2. 2. Ответ в течение 24 рабочих часов

    Сотрудник команды партнёров свяжется, чтобы уточнить задачу и запланировать 30-минутный технический скоупинг.

  3. 3. Доступ в sandbox

    Sandbox-токен, документация и примеры отправляются сразу же. Вы можете начать писать код немедленно, без обязательств.

  4. 4. Контракт и go-live

    После валидации POC мы подписываем контракт (комиссия или подписка), затем переходим в прод с постепенным rollout и совместным мониторингом.

Вопросы по API

Самые частые технические вопросы

Вопросы, которые мы разбираем с партнёрами на этапе технического скоупинга и тестирования sandbox.

Действительно ли API позволяет бронировать и выпускать билеты?

Да. API покрывает весь путь: поиск, выбор предложения, создание именных пассажиров, оплата, выпуск билета (PDF, штрих-код, Apple Wallet / Google Wallet в зависимости от оператора) и отправка подтверждений.

Как работает отмена и возврат?

Каждый выпущенный билет можно отменить через отдельный эндпоинт. Правила отмены (сроки, возвращаемая сумма, комиссия) возвращаются API до подтверждения. Возврат запускается автоматически по условиям оператора и исходному способу оплаты.

Есть ли у вас доступ к предпродажам операторов?

Да. Наш движок учитывает календари открытия продаж основных операторов (TGV, Eurostar, Trenitalia, Renfe, FlixBus). Вы можете заранее обращаться к API и получать webhook, как только билеты становятся доступны.

Какой формат? REST, GraphQL, gRPC?

REST + JSON, со спецификацией OpenAPI 3, доступной для скачивания. Это формат, лучше всего поддерживаемый партнёрскими инструментами интеграции (Postman, генерация SDK, API gateways). GraphQL публично не предоставляется.

Какая аутентификация?

По умолчанию OAuth 2 client credentials для интеграций server-to-server с ротацией секретов на стороне партнёра. Долгоживущие API-ключи возможны для отдельных случаев (CI, edge functions). Все запросы должны идти по TLS 1.2+.

Есть ли sandbox? Он бесплатный?

Да, sandbox полностью бесплатный и без обязательств. Он предоставляет те же эндпоинты, что и продакшен, на стабильном наборе тестовых данных. Вы можете держать его открытым столько, сколько нужно, чтобы интегрировать, протестировать и продемонстрировать внутри компании.

Какие сроки получения доступа?

В течение 24 рабочих часов — первый ответ от команды партнёров. Sandbox-токен обычно выдаётся в течение 48 рабочих часов после технического скоупинга.

Как вы тарифицируетесь в продакшене?

Три модели: комиссия с продаж (самая распространённая), подписка на платформу + сниженная комиссия или выделенная лицензия для очень больших объёмов. Никакой тарификации, пока вы остаётесь в sandbox.

Соответствуете ли вы GDPR и PCI-DSS?

Да. Персональные данные хостятся в Евросоюзе и обрабатываются по договору обработки данных по GDPR. Платёжный поток идёт через PSP, сертифицированный PCI-DSS уровня 1; Gopaxo никогда не хранит карточные данные в открытом виде.

Запросить доступ к партнёрскому API Gopaxo

Опишите ваш проект — сотрудник команды партнёров ответит в течение 24 рабочих часов со следующими шагами и доступом в sandbox.

Ваши данные используются только для обработки запроса на доступ к API. Никакого маркетингового использования — в соответствии с GDPR.