Intégrer la connectivité eSIM dans votre application
Utilisez ce guide pour associer un achat eSIM à un compte dans votre application. Vous avez besoin d'un espace de travail Bird, d'une intégration API côté serveur et d'un moyen d'authentifier vos clients. Suivez le guide API pour les permissions et les détails des requêtes.
1. Afficher les offres utilisables par votre client
Listez les offres pour la destination du client et affichez la couverture, le volume, la validité et le prix publié de l'offre sélectionnée. Vérifiez la compatibilité de l'appareil et les exigences d'identification avant l'achat.
Pour le renouvellement automatique, utilisez les options de paiement de l'offre pour afficher les modes d'achat disponibles et les conditions acceptées. Conservez la révision de l'offre et le prix indiqué avec la sélection du client. Si le prix change, affichez les nouvelles conditions et demandez au client de les accepter avant d'acheter.
2. Associer l'achat à votre client
Conservez les clés Bird API sur votre serveur. Autorisez l'accès à chaque commande et eSIM via le compte client de votre application ; une clé API d'espace de travail peut accéder aux ressources de plusieurs clients.
Stockez votre identifiant client avec l'identifiant de commande et, une fois la livraison effectuée, les identifiants de l'eSIM et du forfait. Si vous avez besoin d'un utilisateur de service nommé ou d'un renouvellement automatique, créez un abonné à partir d'un contact de l'espace de travail. L'attribution enregistre qui utilise l'eSIM ; elle ne connecte pas cette personne à votre application et ne donne pas accès aux identifiants.
Le portefeuille de votre organisation finance l'achat Bird. Si vous facturez votre client séparément, suivez ce paiement indépendamment de la commande eSIM afin de pouvoir résoudre un échec de paiement ou de livraison.
3. Créer un achat unique et récupérable
Générez et stockez une Idempotency-Key avant de créer la commande. Réutilisez cette clé avec la même requête si la réponse est interrompue.
Affichez un état de traitement jusqu'à ce que la commande atteigne un résultat final. Enregistrez la commande avant de diriger le client vers l'installation, et permettez-lui d'y revenir depuis son compte. Pour une commande non financée ou échouée, suivez les étapes de récupération d'achat.
4. Transmettre les instructions d'installation de manière privée
Une fois la commande terminée, créez un lien d'installation hébergé pour le client concerné ou envoyez le lien par e-mail ou SMS. Suivez le guide d'installation pour la livraison, l'expiration, la révocation et la configuration de l'appareil.
Traitez le lien et les détails d'activation comme des identifiants. Ne les incluez pas dans les outils d'analyse, les journaux publics ou les notes de support courantes. Enregistrez la finalisation de l'achat, la livraison du lien et l'installation sur l'appareil comme des résultats distincts.
Si vous remplacez un service de connectivité existant, prévoyez un nouvel achat et une nouvelle installation d'eSIM Bird. Vérifiez l'appareil et le forfait prévus avant que le client ne modifie son service actuel. L'eSIM Bird API n'importe pas un profil existant et ne transfère pas un numéro de mobile.
5. Ajouter une page de compte pour l'utilisation continue
Permettez au client authentifié de rouvrir son eSIM existante, de consulter les soldes et l'expiration du forfait signalés, et de contacter le support. Affichez l'horodatage du solde et les valeurs inconnues de manière exacte.
Utilisez les offres compatibles pour les recharges et le available_actions de l'eSIM pour décider quels contrôles afficher. Expliquez une action désactivée à l'aide de la raison renvoyée, et gérez un refus si la disponibilité change avant la soumission. Suivez le guide des forfaits récurrents pour le renouvellement et l'annulation.
Vérifier l'interruption et la récupération
Fermez le navigateur après l'achat et rouvrez le compte du client. Confirmez que celui-ci mène à la même commande et à la même eSIM. Répétez après le début de l'installation.
Vérifiez qu'une réponse d'achat perdue, un lien d'installation expiré et une valeur d'utilisation inconnue mènent chacun à une action de récupération appropriée. Vérifiez qu'un client ne peut pas ouvrir le lien d'installation ou l'eSIM d'un autre client via votre page de compte.
Étapes suivantes
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.