Integre conectividade eSIM no seu app
Use este guia para conectar uma compra de eSIM a uma conta no seu app. Você precisa de um espaço de trabalho Bird, uma integração API no lado do servidor e uma forma de autenticar seus clientes. Siga o guia API para permissões e detalhes de solicitação.
1. Mostre ofertas que seu cliente pode usar
Liste as ofertas para o destino do cliente e mostre a cobertura, a franquia, a validade e o preço publicado da oferta selecionada. Verifique a compatibilidade do dispositivo e os requisitos de identificação antes da compra.
Para renovação automática, use as opções de checkout da oferta para exibir os modos de compra disponíveis e os termos aceitos. Mantenha a revisão da oferta e o preço cotado junto com a seleção do cliente. Se a cotação mudar, mostre os novos termos e peça ao cliente para aceitá-los antes de comprar.
2. Associe a compra ao seu cliente
Mantenha as chaves Bird API no seu servidor. Autorize o acesso a cada pedido e eSIM usando a conta de cliente do seu app; uma chave API do espaço de trabalho pode acessar recursos pertencentes a vários clientes.
Armazene o ID do seu cliente junto com o ID do pedido e, após a entrega, os IDs do eSIM e do pacote. Se você precisar de um usuário de serviço nomeado ou renovação automática, crie um assinante a partir de um contato do espaço de trabalho. A atribuição registra quem usa o eSIM; ela não autentica essa pessoa no seu app nem concede acesso a credenciais.
A carteira da sua organização financia a compra Bird. Se você cobra seu cliente separadamente, rastreie esse pagamento separadamente do pedido de eSIM para poder resolver uma falha de pagamento ou entrega.
3. Crie uma compra recuperável
Gere e armazene uma Idempotency-Key antes de criar o pedido. Reutilize essa chave com a mesma solicitação se a resposta for interrompida.
Exiba um estado de processamento até que o pedido alcance um resultado final. Salve o pedido antes de enviar o cliente para a instalação e permita que ele retorne ao pedido a partir da conta. Para um pedido sem fundos ou com falha, siga os passos de recuperação de compra.
4. Entregue instruções privadas de instalação
Após a conclusão do pedido, crie um link de instalação hospedado para o cliente pretendido ou envie o link por e-mail ou SMS. Siga o guia de instalação para entrega, expiração, revogação e configuração do dispositivo.
Trate o link e os detalhes de ativação como credenciais. Mantenha-os fora de ferramentas de analytics, logs públicos e notas de suporte rotineiras. Registre a conclusão da compra, a entrega do link e a instalação no dispositivo como resultados separados.
Se você estiver substituindo um serviço de conectividade existente, planeje uma nova compra e instalação de eSIM Bird. Verifique o dispositivo pretendido e o pacote antes que o cliente altere o serviço existente. O eSIM Bird API não importa um perfil existente nem transfere um número de celular.
5. Adicione uma página de conta para uso contínuo
Permita que o cliente autenticado reabra o eSIM existente, veja os saldos e a expiração do pacote informados, e acesse o suporte. Exiba o timestamp do saldo e valores desconhecidos com precisão.
Use ofertas compatíveis para recargas e o available_actions do eSIM para decidir quais controles exibir. Explique uma ação desabilitada usando o motivo retornado e trate uma recusa se a disponibilidade mudar antes do envio. Siga o guia de pacote recorrente para renovação e cancelamento.
Verifique interrupção e recuperação
Feche o navegador após a compra e reabra a conta do cliente. Confirme que ela leva ao mesmo pedido e eSIM. Repita após o início da instalação.
Verifique se uma resposta de compra perdida, um link de instalação expirado e um valor de uso desconhecido levam, cada um, a uma ação de recuperação adequada. Confirme que um cliente não consegue abrir o link de instalação ou o eSIM de outro cliente pela página de conta do seu app.
Próximos passos
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.