# Obtenir le code d'activation d'une eSIM

> Renvoie ce dont votre client a besoin pour installer une eSIM prête sur son téléphone : le code d'activation complet ( lpa ), ses deux parties ( smdp address…

`GET /v2/api/partner/esims/{id}/activation_code`

<Note>
**Scope requis :** `PARTNER`
</Note>

Renvoie ce dont votre client a besoin pour installer une eSIM prête sur son téléphone : le code d'activation complet (`lpa`), ses deux parties (`smdp_address` et `matching_id`) et un QR code. Tant que l'eSIM n'est pas prête, la requête échoue avec `409 ESIM_NOT_READY`. Attendez le webhook [`partner.esim.ready`](/fr/docs/webhooks/event-catalog#partneresimready), ou le statut `ACTIVE` sur [Obtenir une eSIM](/fr/docs/white-label/get-esim).

Le code d'activation n'est jamais envoyé dans un webhook. Récupérez-le au moment de remettre l'eSIM à votre client.

<Warning>
Toute personne qui installe l'eSIM avec ce code prend le contrôle de la ligne. Envoyez-le uniquement à votre client.
</Warning>

## Champs de la réponse

| Champ | Description |
|-------|-------------|
| `lpa` | Le code d'activation complet, au format `LPA:1$<smdp_address>$<matching_id>` |
| `smdp_address` | L'adresse SM-DP+, pour la saisie manuelle |
| `matching_id` | Le code d'activation, pour la saisie manuelle |
| `qr_code` | Une data URI PNG d'un QR code qui encode `lpa`. Utilisez-la comme `src` d'une balise `<img>`. |

## Comment remettre l'eSIM à votre client

Donnez à votre client l'une de ces options, selon son téléphone :

- **QR code** : affichez `qr_code`. Votre client le scanne depuis les réglages eSIM de son téléphone.
- **Android, saisie manuelle** : donnez `smdp_address` et `matching_id`. Votre client les saisit dans les réglages eSIM de son téléphone.
- **iPhone (iOS 17.4 et versions ultérieures), lien d'installation** : construisez un lien à partir de `lpa`. Votre client l'ouvre sur l'iPhone et l'eSIM s'installe en un geste.

Le lien iPhone est `https://esimsetup.apple.com/esim_qrcode_provisioning?carddata=` suivi de `lpa` encodé pour une URL. Les caractères `$` et `:` doivent être encodés.

<Tabs>
  <Tab title="JavaScript">
    ```javascript
    const { lpa } = activationCode;
    const link =
      "https://esimsetup.apple.com/esim_qrcode_provisioning?carddata=" +
      encodeURIComponent(lpa);
    ```
  </Tab>
  <Tab title="Python">
    ```python
    from urllib.parse import quote

    lpa = activation_code["lpa"]
    link = "https://esimsetup.apple.com/esim_qrcode_provisioning?carddata=" + quote(lpa, safe="")
    ```
  </Tab>
</Tabs>

Votre client doit se trouver en France au moment d'activer l'eSIM. Consultez [eSIM (France)](/fr/help/phone-numbers/esim) pour les étapes d'installation sur chaque téléphone.

Allo ne détecte pas l'installation de l'eSIM sur le téléphone. La ligne sonne déjà sur l'eSIM dès qu'elle est prête.

## Erreurs

| Code | Signification |
|------|---------------|
| `ESIM_NOT_READY` | L'eSIM n'est pas encore prête à installer. Toujours `retryable: true`. |
| `PARTNER_ESIM_REVOKED` | L'eSIM a été [révoquée](/fr/docs/white-label/revoke-esim) (`409`) : son code d'activation n'est plus disponible. |
| `PARTNER_ESIM_NOT_FOUND` | Aucune eSIM avec cet id n'a été commandée sur un compte créé par votre clé API. |
| `ESIM_UNAVAILABLE` | Le code d'activation ne peut pas être lu pour le moment. Réessayez plus tard. |
