HarborOrganizaçãoEspaços de trabalhoProduçãoSandbox
Agente de envio
Chave de API · Equipe de operações do clienteALAlex Lee AdministradorPermissões atualizadas
Integre dados móveis no seu app.
Use a API de eSIM para descobrir ofertas de dados, comprar pacotes e entregar links de instalação privados a partir da sua aplicação. Mantenha os clientes na experiência da sua própria conta para saldos reportados, recargas compatíveis e compras recorrentes quando disponíveis.
Comece pelas ofertas disponíveis.
Use uma chave de API server-side com permissão de leitura de eSIM para explorar o catálogo. Este exemplo lista ofertas sem comprar um pacote.
1
bird esim offers listDa oferta ao pedido
Transforme uma oferta em uma compra recuperável.
Leia a cobertura, a franquia e a validade da oferta e depois obtenha o preço atual de checkout. A carteira da sua organização financia a compra. Salve o pedido resultante para que o cliente possa retornar a ele enquanto Bird provisiona o eSIM e o pacote de dados.
Apresente os termos aceitos
Envie a revisão da oferta aceita e o preço junto com o pedido. Se os termos mudarem antes da compra, mostre a cotação atualizada para aceitação. Compras recorrentes têm seus próprios termos disponíveis e cronograma.
Recupere sem outra compra
Salve uma chave de idempotência antes de criar um pedido e reutilize-a com a mesma solicitação se a resposta for interrompida. Se você tiver o ID do pedido, leia esse pedido primeiro para descobrir se ele foi concluído.
Instalação hospedada
Envie a configuração que o cliente pode abrir.
Após a conclusão do pedido, crie um link de instalação hospedado ou envie-o por e-mail ou SMS. O cliente abre instruções específicas do dispositivo sem fazer login em um espaço de trabalho Bird. Acompanhe a entrega da mensagem separadamente da instalação e da primeira conexão de dados móveis.
Controle o acesso à instalação
Credenciais de instalação usam permissões de API separadas. Verifique a expiração do link hospedado e revogue-o se ele chegar à pessoa errada. Revogar um link impede acesso futuro por meio dele; não desativa um perfil já instalado.
Leia os saldos do pacote
Mostre a franquia comprada, a expiração e o consumo reportado com seu horário de observação. Quando o uso não estiver disponível, mantenha-o como desconhecido para que os clientes possam distinguir a franquia do pacote de um saldo restante medido.
Compras contínuas
Permita que os clientes adicionem dados ao mesmo eSIM.
Liste ofertas compatíveis para um eSIM existente antes de apresentar uma recarga. Uma recarga concluída adiciona um pacote ao perfil instalado, então o cliente pode continuar usando aquele eSIM sem outra instalação.
Agende pacotes recorrentes
Quando uma oferta suporta renovação, atribua a pessoa que usa o eSIM e aceite o preço recorrente e a cadência. Acompanhe o pagamento e a entrega do pacote de cada período e permita que o cliente interrompa renovações futuras.
Mantenha o acesso do cliente no seu app
Autentique seus clientes e autorize o acesso aos próprios pedidos e eSIMs deles. Uma chave de API do espaço de trabalho pode acessar recursos de vários clientes, então mantenha-a no seu servidor e conecte cada recurso à conta correta.
Perguntas sobre a API de eSIM
O que posso construir com a API de eSIM?
Integre descoberta de ofertas, compra de pacotes de dados, entrega de instalação e gerenciamento contínuo de pacotes no seu app. Os clientes podem comprar recargas compatíveis e aderir a compras recorrentes quando disponíveis. Sua aplicação controla a autenticação do cliente e qualquer pagamento que coleta dele.
O que eu preciso para fazer uma compra?
Use um espaço de trabalho Bird, uma chave de API server-side com as permissões de eSIM necessárias e fundos na carteira da organização. Revise a oferta, os termos de checkout e os requisitos de identificação antes de comprar. Ler credenciais e criar ou enviar links de instalação exigem permissões de credencial separadas.
Como devo lidar com uma resposta de compra interrompida?
Leia o pedido existente se você tiver o ID dele. Caso contrário, repita a solicitação de criação salva com sua chave de idempotência original. Acompanhe esse pedido até a conclusão ou falha antes de criar um substituto que possa causar outra cobrança.
Um pedido concluído significa que o cliente está online?
Um pedido concluído identifica o eSIM e o pacote comprados. O cliente ainda precisa instalar o perfil em um dispositivo compatível e testar os dados móveis em um destino coberto. Relatórios de instalação e saldo podem chegar após o resultado do dispositivo.
Conecte o serviço completo
Instalação de eSIMAjude os clientes a instalar no dispositivo e se conectar com orientações claras.Uso e recargasExiba a franquia e a validade, depois ofereça dados adicionais compatíveis.Operações de conectividadeResolva problemas de compra, instalação e pacote com os registros de serviço existentes.Biblioteca de recursos eSIMExplore guias práticos, respostas explicadas e referências técnicas.
Escale sem
perder o controle.
Organize equipes em espaços de trabalho, controle o acesso à API e rastreie alterações nos logs de auditoria.
HarborOrganizaçãoAtivo
Registo de auditoria
Produção- Espaço de trabalho
- Produção
- Recurso
- Agente de envio
- Acesso de leituraLeitura e escrita
Equipe Operações do clienteFunção do autor da ação AdministradorResultado Concluído com sucessoHorário 22 set, 09:42:18 UTC
Concluído com sucesso