Integração de API de eSIM
Integração da API da Airalo: venda eSIMs em cada viagem
Conecte sua conta de parceiro da Airalo ao PHPTRAVELS e venda eSIMs locais, regionais e globais no seu próprio site, ao lado de voos, hotéis e passeios. O conector está pronto: adicione seu Client ID e Client Secret, teste no sandbox, sincronize os pacotes, defina seu preço e entre no ar.
- Conector da Airalo pronto
- Airalo Partner API v2
- QR code e passos de instalação
- Seu próprio preço de venda
O fornecedor
O que é a Airalo e por que as agências vendem seus eSIMs
A Airalo vende eSIMs: pacotes de SIM digitais que o viajante instala no telefone sem remover o chip físico. Em vez de comprar um chip local no aeroporto, o viajante compra dados antes da viagem e os instala em poucos minutos.
Com a Partner API da Airalo, uma empresa de viagens pode vender esse inventário no próprio site ou app. O PHPTRAVELS inclui um conector da Airalo no módulo eSIM, então o eSIM vira mais um produto no mesmo carrinho do voo, hotel, traslado, visto ou passeio.
Relacionado:eSIMAPIs de viagensIntegração de API de viagens
- Empresa
- Airalo, provedora de conectividade eSIM
- Cobertura
- Mais de 200 destinos, segundo a Airalo
- Pacotes
- eSIMs locais, regionais e globais
- API
- Partner API v2 · REST · token Bearer
- SDKs
- PHP · Node.js · Python
- No PHPTRAVELS
- Conector pronto no módulo eSIM
Passo 1 · Conta de parceiro
Solicite uma conta de parceiro da Airalo
O acesso à API da Airalo exige um acordo de parceria com a Airalo. O PHPTRAVELS não emite contas nem chaves da Airalo: você faz a solicitação, a Airalo analisa sua empresa e envia suas credenciais.
O que enviar à Airalo
- Nome da empresa e site
- País e tipo de negócio
- Volume previsto de vendas de eSIM
- Mercados e destinos-alvo
- B2C, B2B ou ambos
- Que você usa o PHPTRAVELS
Passo 2 · Credenciais
Client ID, Client Secret e o token de acesso
Quando a Airalo aprova sua conta, você recebe um Client ID e um Client Secret. O PHPTRAVELS os envia ao endpoint de token a partir do seu servidor, recebe um token de acesso Bearer e o usa em cada requisição de pacotes, pedidos e eSIM.
1# Server-side only: the Client Secret never reaches the browser 2curl -X POST "$AIRALO_API/v2/token" \ 3 -H "Accept: application/json" \ 4 -F "client_id=$CLIENT_ID" \ 5 -F "client_secret=$CLIENT_SECRET" \ 6 -F "grant_type=client_credentials" 7 8# → { "data": { "access_token": "eyJ0eXAi…", "expires_in": … } } 9# then: Authorization: Bearer <access_token>
- Somente no servidor
- O token é solicitado pelo seu servidor PHPTRAVELS. O Client Secret nunca chega ao navegador.
- Reuso do token
- O conector guarda o token até ele expirar, então não pede um novo a cada busca.
- Mantenha o secret privado
- Nunca coloque o Client Secret em JavaScript público, HTML, um repositório Git público, uma captura de tela ou um fórum.
- Uma conta, dois modos
- A Airalo permite escolher Sandbox ou Production na configuração. Teste tudo primeiro no Sandbox.
O fluxo da Partner API
Cinco chamadas à API da Airalo por trás de cada venda de eSIM
Do primeiro preço na tela até o QR code no e-mail do viajante, o conector usa as mesmas cinco chamadas. Cada uma mostra o que o PHPTRAVELS faz com a resposta.
- 01Obter um tokenPOST/v2/token
PHPTRAVELSFaz login com seu Client ID e Client Secret e guarda o token Bearer no servidor.
- 02Listar pacotesGET/v2/packages
PHPTRAVELSSincroniza pacotes locais, regionais e globais com dados, validade, cobertura e preço líquido, e aplica o seu preço.
- 03Enviar um pedidoPOST/v2/orders
PHPTRAVELSApós o pagamento, pede o ID do pacote e a quantidade escolhidos e salva o pedido da Airalo na reserva.
- 04Ler o eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSLê o eSIM pelo ICCID: QR code, código de ativação, endereço SM-DP+ e o link de instalação direta no iOS.
- 05Passos de instalaçãoGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSObtém as instruções de instalação da Airalo para o aparelho e o idioma do viajante e as adiciona ao voucher.
Passos 3 a 5 · Painel do PHPTRAVELS
Configure, teste e sincronize a Airalo no seu painel
Tudo acontece nas configurações do módulo eSIM do seu painel PHPTRAVELS. Os campos exatos dependem da sua versão do PHPTRAVELS.
- 01Ative o módulo eSIMAbra as configurações do módulo e ative a integração eSIM da Airalo.
- 02Informe suas credenciaisCole o Client ID e o Client Secret da Airalo, escolha Sandbox e salve.
- 03Teste a conexãoUse o botão de teste. O PHPTRAVELS faz login na Airalo e mostra o status conectado ou o erro a corrigir.
- 04Sincronize os pacotesCarregue os pacotes da Airalo e confira se destinos, dados, validade e preços aparecem corretamente no seu site.
Ambiente
Pedidos de teste: nenhum eSIM real é emitidoPedidos reais: eSIMs reais, cobrados do seu saldo Airalo
Tela de exemplo. Os campos podem variar na sua versão.
Passo 5 · Pacotes eSIM
eSIMs locais, regionais e globais em um só feed
A Airalo retorna três tipos de pacotes, para você adequar o eSIM ao roteiro do viajante. Pacotes, preços e disponibilidade sempre vêm em tempo real da Airalo.
eSIM local
Um destino, para uma viagem a um único país.
ExemploeSIM EUA
eSIM regional
Vários países de uma região, para uma viagem por vários países.
ExemploeSIM Europa
eSIM global
Países de várias regiões, para viagens longas ou de volta ao mundo.
ExemploeSIM global
- O que o viajante vê
- Destino · nome do pacote · dados · validade · rede · cobertura · preço
- Tamanhos de dados comuns: 1 GB, 3 GB, 5 GB e 10 GB, cada um com sua própria validade.
Passos 6 a 9 · A venda
Como um viajante compra um eSIM da Airalo no seu site
O viajante nunca sai do seu site. O PHPTRAVELS cuida da reserva e do pagamento, e a Airalo emite o eSIM.
- 01Viajante
Abre a seção de eSIM do seu site
- 02Viajante
Escolhe um destino
- 03PHPTRAVELS
Mostra os pacotes da Airalo com o seu preço
- 04Viajante
Escolhe um pacote
- 05Viajante
Reserva e paga pelo seu gateway de pagamento
- 06PHPTRAVELS
Envia o pedido à API da Airalo
- 07Airalo
Emite o eSIM
- 08Airalo
Retorna o QR code e os dados de instalação
- 09PHPTRAVELS
Envia o eSIM ao viajante por e-mail e na conta
Entrega do eSIM
Cinco formas de o viajante instalar o eSIM
A Airalo oferece vários fluxos de instalação para parceiros da API. O PHPTRAVELS coloca os dados no voucher da reserva, no e-mail de confirmação e na conta do viajante.
QR code
O viajante escaneia o QR code nas configurações de eSIM do telefone.
Inserção manual
O código de ativação e o endereço SM-DP+, para telefones que não conseguem escanear.
Instruções da Airalo
Instruções de instalação passo a passo pela API, por aparelho e idioma.
Link eSIM Cloud ou PDF
Um link de compartilhamento ou PDF da Airalo com o guia de instalação completo.
Instalação direta no iOS
Um link de instalação com um toque para iPhones compatíveis em versões de iOS suportadas.
Dados do cliente
Vincule cada cliente a um ICCID
A Airalo identifica cada eSIM pelo ICCID e, neste fluxo, não armazena os dados pessoais dos seus viajantes. Manter o vínculo entre o viajante e o eSIM é responsabilidade sua, e o PHPTRAVELS faz isso na reserva.
- Cliente
- Reserva no PHPTRAVELS
- Pedido da Airalo
- ICCID
Essa cadeia facilita o suporte:Solicitações de suporteProblemas de instalaçãoConsulta de pedidosHistórico de reservasStatus do eSIM
Passo 7 · Seu preço
Defina seu preço de venda e ganhe em cada eSIM
A Airalo cobra de você o custo do pacote conforme seu acordo comercial. Você decide quanto o viajante paga, dentro do seu acordo com a Airalo.
Margem fixa
O mesmo valor sobre cada pacote.
Margem percentual
Uma porcentagem do preço líquido, para que a margem cresça com planos maiores.
Taxa de serviço
Uma taxa separada por pedido, exibida no checkout.
Incluído em um pacote
Um eSIM incluído em um pacote de férias ou como brinde com um voo.
- Voo para Dubai
- Hotel em Dubai
- Traslado do aeroporto
- eSIM Emirados Árabes
Por que as agências adicionam eSIMs
- Mais receita por reserva
- Um serviço adicional de que quase todo viajante internacional precisa
- Entrega digital imediata, sem estoque
- Os viajantes voltam para a próxima viagem
A opção de vouchers. A Airalo também vende vouchers de eSIM: você compra códigos de ativação e os distribui pelo seu site, app, CRM ou e-mail. Escolha o método que corresponde ao seu acordo com a Airalo.
Solução de problemas
Quando algo não funciona, verifique isto primeiro
A maioria dos problemas vem das credenciais, do ambiente ou do aparelho. Percorra a lista do problema que você vê.
- O teste de conexão falha
- Client IDClient Secretconta de parceiro ativaacesso à API habilitadoSandbox ou ProductionHTTPS de saída do seu servidorSSL
- Nenhum pacote eSIM aparece
- Conexão com a APIdisponibilidade dos pacotesambientefiltros de destinoresposta da APIcache do PHPTRAVELS
- Um pedido falha
- Pacote inválido ou indisponívelsaldo Airalofalha no tokenerro de redeambiente erradoproblema temporário na Airalo
- O QR code não aparece
- Pedido concluídoeSIM emitidoICCID salvodados de instalação retornadoscampos de QR na resposta da API
- O viajante não consegue instalar
- Telefone compatível com eSIMtelefone desbloqueadoo QR code corretoeSIM ainda não instaladoroaming ativadoAPN quando necessário
Quem faz o quê
O PHPTRAVELS cuida do software, a Airalo cuida dos eSIMs
A Airalo é um fornecedor externo. A relação comercial é entre a sua empresa de viagens e a Airalo.
PHPTRAVELS
- O conector da Airalo e suas configurações
- As páginas de eSIM, a busca e o checkout
- Sua margem e seus gateways de pagamento
- Vouchers, e-mails e o ICCID na reserva
- Suporte para a própria integração
Airalo
- Aprovação de parceiros e credenciais da API
- Preços dos pacotes, comissões e regras de saldo
- Cobertura, redes e disponibilidade dos pacotes
- Disponibilidade da API e emissão de eSIMs
- Seu acordo comercial
Segurança
Proteja suas credenciais da Airalo
- Autentique somente pelo servidor, nunca em JavaScript no navegador
- Use HTTPS no seu site e no painel
- Proteja o painel administrativo e restrinja o acesso ao servidor
- Mantenha o PHPTRAVELS atualizado
- Monitore atividades incomuns na API
Airalo
Precisa de ajuda com a integração?
Se sua conta Airalo foi aprovada mas a integração mostra um erro, abra um ticket de suporte na sua conta PHPTRAVELS com: sua versão do PHPTRAVELS, uma captura das configurações da Airalo, o resultado do teste, um destino e um pacote de exemplo, o código da reserva e a mensagem de erro. Nunca inclua o Client Secret completo.
Leia: como agências de viagens podem vender eSIMs onlineDocumentação para desenvolvedores da Airalo
Não. Você precisa de uma conta de parceiro da Airalo aprovada em seu nome. O PHPTRAVELS fornece o software e o conector da Airalo pronto.
A Airalo envia o Client ID e o Client Secret depois de aprovar sua conta de parceiro. O PHPTRAVELS não os emite.
Clientes PHPTRAVELS podem enviar e-mail a Rao Suhaib Khan, Head of Partnerships da Airalo, em rao.khan@airalo.com, e mencionar que usam o PHPTRAVELS.
Sim. Com uma conta de parceiro da Airalo aprovada e o conector do PHPTRAVELS, os pacotes compatíveis da Airalo aparecem no seu próprio site e a reserva fica no seu site.
Sim, uma margem fixa ou percentual ou uma taxa de serviço, desde que esteja de acordo com seu contrato comercial com a Airalo.
Sim. A Airalo tem um modo Sandbox em que os pedidos de teste não emitem eSIMs reais. Mude para Production somente quando todo o fluxo funcionar.
Sim. A Airalo oferece pacotes locais, regionais e globais, conforme o inventário disponível para cada destino.
Com o QR code, digitando o código de ativação e o endereço SM-DP+, com as instruções passo a passo da Airalo, por um link eSIM Cloud ou PDF, ou com um link de instalação direta em iPhones compatíveis.
Não. A Airalo tem SDKs para PHP, Node.js e Python, mas o conector já está no PHPTRAVELS. Você só adiciona suas credenciais.
Continue a explorar
Mais sobre a plataforma
- eSIM
- Integração API TiqetsIngressos de atrações Tiqets no seu motor de reservas
- Integração da API ViatorPasseios e atividades Viator no seu site de reservas
- Integração PKFARE APIBusca, reserva e PNR da PKFARE no seu portal
- Integração da API RateHawkHotéis RateHawk no seu motor de reservas, conector pronto
- APIs de viagensAPIs de GDS, hotéis, tours, carros e pagamentos