# Planifier votre intégration eSIM

L'accès public à l'eSIM API n'est pas encore disponible. Ce guide vous aide à préparer un cahier d'intégration pour un [spécialiste eSIM](/demo?product=esim-api). Confirmez l'accès et obtenez le contrat API pris en charge avant d'implémenter des requêtes ou d'assigner un agent à la construction de l'intégration.

## Définir le client et le service

Identifiez qui achète le service, qui utilise l'appareil et qui paie. Un achat de voyage peut appartenir à un seul compte client. Un service pour employé nécessite aussi une affectation à une personne et un responsable habilité à approuver les modifications.

Listez les enregistrements que votre application doit relier : l'achat, le profil installé et son enveloppe de consommation. Un service mobile récurrent nécessite aussi la relation d'abonnement en cours de l'abonné. Ce sont des exigences à confirmer par rapport au contrat du service récepteur.

## Spécifier le résultat de l'achat

Décidez où les clients voient l'offre sélectionnée, la couverture, la validité et le prix affiché. Conservez la devise indiquée telle quelle. Votre application ne doit pas recalculer un tarif client à partir de coûts de gros ou d'une conversion de devise estimée.

Pour chaque achat, définissez ce que le client voit après acceptation, exécution ou refus. Incluez un cas de réponse perdue dans le cahier d'intégration. Confirmez comment le API identifie une opération existante avant de concevoir une logique de réessai qui pourrait créer une facturation supplémentaire.

Un paiement finalisé ne prouve pas qu'un appareil a installé ou utilisé le service. Gardez ces résultats séparés dans le parcours client.

## Planifier l'installation et le support

Choisissez les appareils pris en charge et la personne responsable d'aider un client à se connecter. Les identifiants d'installation nécessitent un canal de livraison privé et autorisé. Ne les incluez pas dans les données analytiques, les exemples publics ni les captures d'écran du support.

Listez les informations dont le client a besoin après l'achat : instructions de configuration, forfait acheté, observations de consommation et contact de support. Confirmez quels états et quels délais d'observation le service peut fournir avant de concevoir l'affichage de statut.

## Convenir de la liste de contrôle d'implémentation

Demandez à votre spécialiste Bird de confirmer les marchés, les offres éligibles, les conditions d'accès et les opérations publiées pour votre cas d'usage. Obtenez les définitions de requêtes et de réponses, les exigences d'autorisation, le comportement de réessai et les méthodes d'installation prises en charge.

Une fois ce contrat disponible, transmettez à votre agent de développement le contrat et le modèle d'identité de votre application. Faites-lui tracer un achat jusqu'à son résultat confirmé, et couvrir une requête refusée et une réponse incertaine. Testez avec un compte et un appareil explicitement autorisés avant de proposer le service aux clients.

## Relier l'acquisition au résultat

Conservez le contexte de campagne autorisé tout au long de l'inscription et du parcours client de votre application. Définissez quel résultat enregistré comptera comme conversion, par exemple un achat exécuté ou une première utilisation vérifiée. Un identifiant de campagne sur une URL d'inscription ne prouve pas à lui seul qu'un achat ultérieur a été attribué.

## Étapes suivantes

- [Planifier une offre de voyage](/docs/guides/esim/travel)
- [Préparer l'installation](/docs/guides/esim/installation)
- [Définir le support de service](/docs/guides/esim/operations)
- [Options d'intégration eSIM](/products/esim/api)

## Related resources

- [What is an eSIM?](/explained/esim/what-is-an-esim) (answer)
- [eSIM](/products/esim) (product)
- [eSIM connectivity guide](/docs/guides/esim/overview) (docs)

[Get an implementation brief](/learn/workspace?topic=esim)