# Commander une eSIM

> Commande une eSIM pour l'un des numéros du compte et la débite sur votre crédit prépayé en priorité, puis sur votre carte enregistrée. La réponse renvoie…

`POST /v2/api/partner/accounts/{account_id}/esims`

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

Commande une eSIM pour l'un des numéros du compte et la débite sur votre crédit prépayé en priorité, puis sur votre carte enregistrée. La réponse renvoie l'eSIM avec le statut `PROVISIONING`. L'eSIM est en général prête 5 à 15 minutes plus tard, et Allo vous envoie alors le webhook [`partner.esim.ready`](/fr/docs/webhooks/event-catalog#partneresimready).

## Requête

- `phone_number` est requis. Ce doit être l'un des numéros du compte ou de ses membres, créé avec `number_preference.esim` à `true` (voir [Créer un compte](/fr/docs/partner/create-account), [Ajouter un numéro](/fr/docs/white-label/add-number) et [Ajouter un membre](/fr/docs/white-label/add-member)). Tout autre numéro échoue avec `PARTNER_ESIM_NUMBER_NOT_FOUND` ou `ESIM_NOT_ELIGIBLE`.
- `tier` est requis : un `code` renvoyé par [Obtenir l'offre eSIM](/fr/docs/white-label/get-esim-offer), par exemple `ESIM_20GB`. Un code inconnu échoue avec `INVALID_ESIM_TIER`.
- `holder_id` est optionnel : l'utilisateur Allo auquel l'eSIM est rattachée. Omettez-le pour que le compte lui-même en soit le titulaire. Pour le numéro d'un membre, envoyez l'`id` du membre renvoyé par [Ajouter un membre](/fr/docs/white-label/add-member) ou [Lister les membres](/fr/docs/white-label/list-members). Cela vaut aussi pour un numéro que le membre a repris avec `phone_number`.
- `identity` est requis : l'entreprise à laquelle la ligne est enregistrée. `corporate_name`, `postal_address`, `postal_code` (5 chiffres) et `city` sont requis. `first_name`, `last_name`, `company_name`, `siret`, `naf` et `email` sont optionnels. Un champ requis manquant échoue avec `ESIM_IDENTITY_INCOMPLETE`.

## Facturation

- Les frais de mise en service et la première période du palier sont facturés sur l'abonnement que vous payez pour le compte, avec votre remise partenaire appliquée. Allo prélève d'abord votre [crédit prépayé](/fr/docs/partner/get-credit), puis débite le reste sur votre carte enregistrée. Allo ne facture jamais votre client.
- Si votre crédit prépayé ne couvre pas la commande et qu'aucune carte n'est enregistrée, la requête échoue avec `402 PARTNER_CREDIT_INSUFFICIENT`. Rechargez votre crédit ou ajoutez une carte, puis réessayez avec une nouvelle `Idempotency-Key`.
- Une carte qui exige 3D Secure est refusée avec `402 ESIM_PAYMENT_FAILED`. Une carte refusée échoue de la même façon. Rien ne reste en attente : mettez à jour votre carte dans le [portail partenaire](/fr/help/support/partner-portal), puis réessayez.
- Un numéro dont l'eSIM a été [révoquée](/fr/docs/white-label/revoke-esim) peut recevoir une nouvelle eSIM. La nouvelle commande facture à nouveau les frais de mise en service. Si vous la passez juste après la révocation, elle reste `PROVISIONING` jusqu'à ce que le réseau mobile ait confirmé la révocation.
- Si l'abonnement que vous payez pour le compte ne peut pas recevoir d'eSIM pour le moment, la requête échoue avec `ESIM_SUBSCRIPTION_CONFLICT`. Si l'erreur indique `retryable: true`, réessayez dans quelques minutes.

## Nouvelles tentatives

Envoyez un en-tête `Idempotency-Key` (8 à 100 lettres, chiffres, `-` ou `_`, par exemple un UUID) et réutilisez-le pour réessayer la même commande. Une nouvelle tentative avec la même clé ne vous débite pas deux fois. Une clé dans un autre format échoue avec `INVALID_IDEMPOTENCY_KEY`.

## Erreurs propres au numéro

| Code | Signification |
|------|---------------|
| `ESIM_ALREADY_EXISTS` | Le numéro a déjà une eSIM non révoquée. Consultez-la avec [Obtenir une eSIM](/fr/docs/white-label/get-esim), ou [révoquez-la](/fr/docs/white-label/revoke-esim) pour en commander une nouvelle. |
| `ESIM_ORDER_IN_PROGRESS` | Une commande pour ce numéro est encore en cours de provisionnement. Attendez `partner.esim.ready` ou `partner.esim.failed`. |
| `ESIM_ORDER_NEEDS_SUPPORT` | Une précédente commande a été débitée sans aboutir, et le support Allo la traite. Écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co) avant de commander à nouveau. |
| `PARTNER_ESIM_HOLDER_NOT_FOUND` | `holder_id` ne peut pas détenir d'eSIM pour ce numéro. Omettez-le pour utiliser le compte. |
