API de seguro viagem para integrar no site da agência
Tópicos
Uma API de seguro viagem é a ligação técnica que deixa o site, o sistema de reservas ou o aplicativo da agência cotar e emitir o seguro direto na base da empresa de seguro viagem, sem o agente abrir outra plataforma. O cliente escolhe o plano dentro da sua página, paga e recebe o bilhete. É um caminho para agência com sistema próprio e alguém para programar a integração. Quem vende pelo balcão ou pelo WhatsApp costuma resolver com a plataforma de emissão da empresa, sem desenvolvimento nenhum. A escolha depende do tamanho da operação e de onde o seu cliente compra.
O que uma API de seguro viagem faz
A documentação pública da Assist Card mostra bem o desenho típico. A API dela, do tipo REST, tem funções para:
- Autenticar o sistema da agência e gerar o token de acesso.
- Cotar os planos e as tarifas disponíveis para a viagem.
- Cotar adicionais, as ampliações de cobertura ligadas a cada plano.
- Emitir o voucher de cada passageiro, na mesma transação da cotação.
- Consultar emissões por código do voucher, grupo, documento ou código da reserva.
- Cancelar, alterar o início da vigência e reenviar o e-mail de confirmação da emissão.
O pagamento pode seguir três modelos nessa documentação: a agência cobra o cliente no próprio sistema e emite em conta corrente; a API gera um link de pagamento, e o voucher só fica válido quando o pagamento é confirmado; ou o cartão é cobrado direto pelo gateway da Assist Card, o que exige do sistema da agência a certificação de segurança de dados de cartão (PCI). As credenciais de produção só são liberadas depois da certificação da integração, e o acesso pede IPs públicos fixos.
O que a sua agência precisa ter
- Um sistema onde o seguro vai entrar: site com carrinho, motor de reservas ou sistema de gestão.
- Alguém para programar e manter a integração, interno ou contratado.
- Uma decisão sobre o pagamento: cobrar no seu checkout ou usar o da empresa de seguro viagem.
- Tempo para testes. Na documentação da Assist Card, a integração passa por ambiente de testes e por certificação antes da produção.
- Um acordo comercial com a empresa: a API não substitui o cadastro de parceiro.
As empresas e o que cada uma publica sobre API
Hero Seguros
A Hero Seguros, MGA brasileira de seguro viagem e assistência ao viajante, oferece API para operadoras e parceiros grandes venderem o seguro viagem pelo próprio sistema. A Hero vende prioritariamente por parceiros, numa rede de mais de 5 mil agências e corretores, e para quem não tem sistema próprio o caminho é o Xavier, a plataforma de cotação e emissão da Hero, ou o agente de IA no WhatsApp que cota e emite. Como MGA, a Hero desenvolve produtos, tecnologia, distribuição e atendimento em parceria com diferentes seguradoras.
Assist Card
A Assist Card publica a documentação completa da sua API de emissão, em espanhol, com as funções de autenticação, cotação, adicionais, emissão em três modos de pagamento, consulta, cancelamento, alteração de vigência e reenvio do e-mail de confirmação. A documentação traz o endereço do ambiente de testes e o de produção, e as credenciais são pedidas à equipe de suporte de web services. É a opção para quem quer ler a parte técnica antes da primeira reunião.
Affinity
A Affinity lista, na página de imprensa do próprio site, a adoção de uma nova API REST e a ampliação do suporte a parceiros, em julho de 2025. O acesso começa pela área de agência e corretora do site.
Porto Seguro
A Porto mantém um portal de desenvolvedores com APIs para parceiros e desenvolvedores integrarem seguros, serviços e soluções financeiras, com documentação, credenciais e suporte num só lugar. O formulário de parceria do portal inclui seguro viagem entre os produtos de interesse.
As regras que valem dentro do seu checkout
Vender pela API não muda as regras de oferta do seguro. Algumas delas tocam direto no desenho da sua página:
- Condições gerais antes da emissão. Pela Circular SUSEP 667/2022, as condições contratuais têm de estar à disposição do cliente antes da emissão do bilhete (art. 9º) e ser disponibilizadas na emissão (art. 12). No checkout, isso é um link visível antes do botão de pagar.
- A frase da SUSEP em todo material de venda. A mesma circular manda incluir em todo material de comercialização e publicidade que o registro do produto é automático e não representa aprovação ou recomendação por parte da SUSEP (art. 10, § 2º).
- Seguro junto com o pacote, mas separado. Se a sua agência atua como representante de seguros e oferece o seguro junto com outros produtos, a Resolução CNSP 431/2021 pede transparência sobre o que está sendo comprado e o preço de cada item, manifestação expressa do cliente sobre o seguro e formalização em documento próprio, apartado do da compra da viagem (art. 13). A mesma resolução proíbe vincular a compra do seguro à de outro produto (art. 17, III). Na tela, isso quer dizer seguro opcional, com preço próprio e escolha ativa do cliente. Mais sobre o tema em Seguro viagem incluso no pacote ou vendido separado?.
- Quem responde pelas informações. As seguradoras respondem, direta ou indiretamente, pelas informações e serviços prestados por quem comercializa os produtos delas (Circular SUSEP 667/2022, art. 8º). E, pela CNSP 431/2021, o representante não pode fazer publicidade de seguro sem anuência prévia da seguradora (art. 17, II).
API, plataforma ou white label: qual serve para a sua agência
| Caminho | Onde o cliente compra | O que exige da agência | Para quem serve |
|---|---|---|---|
| Plataforma de emissão | O agente emite e envia o bilhete | Cadastro de parceiro | Balcão, telefone e WhatsApp |
| API | No site ou sistema da agência | Desenvolvimento, testes e manutenção | Agência com e-commerce ou motor de reservas |
| White label | Numa loja com a marca da agência | Acordo comercial e configuração da loja | Quem quer a própria marca na frente sem programar |
O white label é o caminho de quem quer a vitrine com a sua marca sem montar a integração. Como ele funciona e quem oferece está em White label de seguro viagem.
Antes de começar a integração
- Confirme o cadastro de parceiro e o modelo de comissão na venda pela API.
- Peça a documentação, o ambiente de testes e o prazo de certificação.
- Defina quem cobra o cliente: o seu checkout ou o da empresa de seguro viagem.
- Desenhe o checkout com as condições gerais e a frase da SUSEP à vista.
- Combine com a empresa o canal de assistência que vai no bilhete e o atendimento ao seu cliente depois da venda.