Pesquisa multimodal
Consulte numa única requisição todos os operadores de comboio e autocarro que servem um trajeto: tarifas, durações, paragens, classes, cartões de desconto e CO₂ devolvidos em tempo real.
API de parceiros
A API europeia de comboio e autocarro para os seus parceiros
Uma única API REST para pesquisar, reservar, anular e aceder às pré-vendas de todas as companhias de comboio e autocarro que distribuímos. Sandbox gratuita, documentação OpenAPI, suporte dedicado a parceiros.
Funcionalidades
Todo o percurso do bilhete, exposto por API
A API de parceiros Gopaxo cobre as quatro etapas críticas do ciclo de vida de um bilhete de comboio ou autocarro, para evitar que integre cada companhia separadamente.
Reserva e emissão
Reserve e emita os bilhetes diretamente a partir da API: passageiros nominais, lugares marcados, opções de bagagem, cartões de desconto, pagamento seguro via o seu PSP ou o nosso.
Anulação e reembolso
Anule um bilhete em poucas chamadas, despolete o reembolso de acordo com as CGV do operador. Estados detalhados, motivos de falha normalizados, registo de eventos rastreável.
Pré-vendas antecipadas
Aceda às aberturas de venda e às pré-vendas dos operadores (TGV, Eurostar, Trenitalia, FlixBus…) assim que estiverem disponíveis. Webhooks para notificar os seus utilizadores em tempo real.
Cobertura de transportadoras
Todas as companhias de comboio e autocarro que distribuímos
A API Gopaxo expõe a totalidade do inventário que operamos no lado público: grandes operadores ferroviários, low-cost e empresas de autocarros de longa distância, em 160 países.
Companhias de comboio
Todos os principais operadores ferroviários e a maioria dos operadores regionais europeus estão acessíveis a partir de um único endpoint.
- SNCF
- OUIGO
- Eurostar
- Thalys
- Trenitalia
- Italo
- Renfe
- Deutsche Bahn
- ÖBB
- SBB
- NS
- SNCB
- CFL
- PKP
- ČD
- MÁV
- CP
- DSB
- VR
- + regionais
Companhias de autocarro
Os principais operadores de autocarro de longa distância europeus estão disponíveis através da mesma API que os comboios.
- FlixBus
- BlaBlaCar Bus
- Alsa
- Megabus
- National Express
- Eurolines
- RegioJet
- Student Agency
- Marino Bus
- Itabus
- Westbahn
- Vy Buss
- Onnibus
- + regionais
Características técnicas
Pensada para equipas de produto e de plataforma
Uma API REST moderna, documentada e observável, pronta para passar por revisão da sua equipa de segurança e arquitetura.
REST + JSON, OpenAPI 3
Endpoints REST documentados em OpenAPI 3, esquemas tipados, exemplos de payloads para cada percurso. Compatível com todos os geradores de SDK do mercado.
OAuth 2 e chaves de API
Autenticação OAuth 2 client credentials ou chaves de API rotativas consoante a sua stack. Scopes granulares por percurso (search, book, cancel) e por ambiente.
Webhooks orientados a eventos
Notificações assinadas (HMAC) nos eventos-chave: confirmação de reserva, alteração de horário, anulação pelo operador, reembolso emitido. Repetições automáticas.
Sandbox gratuita
Ambiente de teste iso-funcional à produção, com dados de teste estáveis. Sem limite de chamadas, sem compromisso, acesso partilhado por toda a sua equipa.
SLA 99,9 % e observabilidade
Disponibilidade contratual 99,9 %, statuspage partilhada, p50 < 800 ms na pesquisa. Logs e traces enviáveis para a sua stack (Datadog, Grafana, Sentry…).
Documentação e SDKs
Portal de programadores completo, exemplos curl e Postman, guias de integração por caso de uso. SDKs oficiais TypeScript e Python, comunidade open-source no GitHub.
Onboarding
Quatro etapas para passar do sandbox à produção
O nosso processo de onboarding foi concebido para entregar rapidamente um POC funcional, sem sacrificar a qualidade da entrada em produção.
1. Envia o formulário
Descreva o seu caso de uso, a sua stack, a sua volumetria-alvo e o seu calendário ideal. 3 minutos bastam.
2. Resposta em 24h úteis
Um membro da equipa de parceiros entra em contacto para qualificar a necessidade e agendar um enquadramento técnico de 30 minutos.
3. Acesso à sandbox
Token sandbox, documentação e exemplos enviados de seguida. Pode começar a programar imediatamente, sem compromisso.
4. Contratualização e go-live
Uma vez validado o POC, contratualizamos (comissão ou subscrição) e depois passamos para produção com um rollout progressivo e um acompanhamento conjunto.
Perguntas sobre a API
As perguntas técnicas mais colocadas
As perguntas revistas com os nossos parceiros durante o enquadramento técnico e o teste da sandbox.
A API permite realmente a reserva e a emissão de bilhetes?
Sim. A API gere o percurso completo: pesquisa, seleção da oferta, criação dos passageiros nominais, pagamento, emissão do bilhete (PDF, código de barras, Apple Wallet / Google Wallet consoante o operador) e envio dos comprovativos.
Como funciona a anulação e o reembolso?
Cada bilhete emitido pode ser anulado através de um endpoint dedicado. As regras de anulação (prazo, valor reembolsável, encargos) são devolvidas pela API antes da confirmação. O reembolso é despoletado automaticamente de acordo com as CGV do operador e o meio de pagamento inicial.
Têm acesso às pré-vendas dos operadores?
Sim. O nosso motor integra os calendários de abertura de vendas dos principais operadores (TGV, Eurostar, Trenitalia, Renfe, FlixBus). Pode consultar a API com antecedência e receber um webhook assim que os bilhetes ficarem disponíveis.
Que formato? REST, GraphQL, gRPC?
REST + JSON, com uma especificação OpenAPI 3 disponível para download. É o formato mais suportado pelas ferramentas de integração dos parceiros (Postman, geração de SDKs, API gateways). GraphQL não está exposto publicamente.
Que autenticação?
OAuth 2 client credentials por defeito para as integrações server-to-server, com rotação dos segredos do lado do parceiro. Continuam a ser possíveis chaves de API de longa duração para casos específicos (CI, edge functions). Todas as requisições devem ser em TLS 1.2+.
Existe uma sandbox? É gratuita?
Sim, a sandbox é 100 % gratuita e sem compromisso. Expõe os mesmos endpoints que a produção, sobre um conjunto de dados de teste estável. Pode mantê-la aberta o tempo que for necessário para integrar, testar e validar internamente.
Quais são os prazos de acesso?
Em 24 horas úteis para o primeiro retorno da equipa de parceiros. O token sandbox é geralmente entregue nas 48 horas úteis seguintes ao enquadramento técnico.
Como são faturados em produção?
Três modelos disponíveis: comissão sobre vendas (o mais comum), subscrição de plataforma + comissão reduzida, ou licença dedicada para volumes muito elevados. Sem faturação enquanto permanecer em sandbox.
São conformes com o RGPD e o PCI-DSS?
Sim. Os dados pessoais são alojados na União Europeia e tratados ao abrigo de contrato de subcontratação RGPD. O fluxo de pagamento passa por um PSP certificado PCI-DSS nível 1; a Gopaxo nunca armazena os dados de cartão em claro.