Points clés
- Modélisez le cycle de vie complet, pas seulement la création de profils.
- Traitez les mises à jour de provisionnement et d’utilisation comme asynchrones.
- Protégez les données d’activation et les informations d’identification.
- Créez une réconciliation, prenez en charge la visibilité et la reprise après incident dès le début.
Définir les systèmes et la propriété
Identifiez le système d’enregistrement du statut du client, du produit, du prix, de la commande, du paiement et de la connectivité. De nombreux problèmes d'intégration proviennent du fait de permettre à deux systèmes de posséder le même domaine. Créez des identifiants qui persistent dans la vitrine, le processeur de paiement et la plateforme de connectivité.
Documentez quel système peut réessayer, annuler, rembourser ou modifier une commande. Définissez la vue d'assistance afin que les agents puissent localiser la même transaction sans rechercher des outils distincts.
Concevoir les flux API de base
Un flux typique récupère les forfaits éligibles, crée ou réserve une commande, confirme le paiement, attribue un profil eSIM et renvoie les informations d'activation. Les flux ultérieurs récupèrent l'état et l'utilisation, ajoutent des packages, traitent l'expiration et prennent en charge la suspension ou le remplacement lorsque le produit le permet.
Séparez les identifiants de produits commerciaux des identifiants de réseau ou de fournisseur. Cela permet à l’offre client de rester stable lorsque la connectivité sous-jacente change.
Utilisez les événements asynchrones en toute sécurité
Le provisionnement et les mises à jour du réseau ne sont pas toujours instantanés. Les webhooks ou les sondages d'événements doivent mettre à jour l'état local sans créer de commandes en double. Vérifiez les signatures, stockez les identifiants d’événements et traitez les événements de manière idempotente.
Représente explicitement les états tels que en attente, prêt, installé, actif, épuisé, expiré, suspendu et en échec. Ne déduisez pas le succès uniquement parce qu'une requête API a été renvoyée sans erreur.
Activation sécurisée et données clients
Les codes d'activation, les données QR, les identifiants clients et les informations d'identification API nécessitent des contrôles d'accès appropriés. Évitez d'écrire des secrets dans des journaux ou des analyses. Utilisez des informations d’identification de courte durée lorsqu’elles sont prises en charge, séparez les environnements de production et de test et alternez les clés.
Le certificat eSIM sous-jacent et l'écosystème d'approvisionnement suivent les spécifications de la GSMA. Votre intégration nécessite toujours une sécurité au niveau des applications, des contrôles de confidentialité et un processus d'incident.
Tester et lancer
Créez des cas de test pour les demandes en double, les délais d'attente, les webhooks retardés, le solde insuffisant, les forfaits indisponibles, la réussite du paiement avec échec d'approvisionnement, l'échec de la recharge, le remboursement et l'escalade du support. Ajoutez des ID de corrélation et des tableaux de bord avant la production.
Lancez avec un volume contrôlé, comparez quotidiennement les commandes avec les enregistrements de la plateforme et définissez qui peut arrêter les ventes si un problème en amont apparaît. Une bonne intégration est un processus opérationnel pris en charge par le code, et non par le code seul.
Questions et réponses
Qu'est-ce que l'idempotence dans une API de commande eSIM ?
Cela signifie que réessayer la même demande logique ne crée pas plusieurs profils ou frais. Utilisez une clé d'idempotence stable et stockez le résultat.
Dois-je utiliser des webhooks ou des sondages ?
Les webhooks fournissent des mises à jour plus rapides, tandis que les interrogations peuvent prendre en charge la récupération et la réconciliation. De nombreuses intégrations fiables utilisent les deux.
Qu'est-ce qui ne devrait jamais être enregistré ?
Évitez de consigner les secrets de l'API, les codes d'activation complets, les charges utiles QR, les informations de paiement et les données personnelles inutiles.