# Vue d'ensemble

> Créez des comptes Allo pour vos clients depuis votre propre logiciel, obtenez leur prix et désactivez-les, en tant que partenaire qui revend Allo.

Un **partenaire** désigne ici un revendeur sous contrat Licence à prix réduit : une entreprise qui revend Allo dans son propre produit ou service. L'API Partner permet à un revendeur de créer les comptes Allo de ses clients depuis son propre logiciel, d'en obtenir le prix et de les désactiver.

Une fois le compte créé, ses membres, ses numéros et ses réglages se gèrent dans l'application Allo, comme pour tout client Allo, et non par l'API Partner.

L'API Partner est optionnelle. Le [portail partenaire](/fr/help/support/partner-portal) crée et configure les comptes sans code.

<Note>
Vous construisez votre propre produit sur Allo, pour des utilisateurs qui n'ouvrent jamais l'application Allo ? Consultez [Marque blanche](/fr/docs/white-label/overview). Elle ajoute les endpoints qui gèrent les membres, les numéros, les eSIM, les suspensions et les Sender ID.
</Note>

## Obtenir l'accès partenaire

Le scope `PARTNER` est accordé manuellement aux revendeurs approuvés, et il ne peut pas être auto-émis. Pour devenir revendeur et recevoir une clé avec le scope `PARTNER`, consultez le [Programme Partenaire](/fr/help/support/partner-program) ou écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co).

Seuls les partenaires Licence à prix réduit (revendeurs) peuvent créer des comptes, en obtenir le prix et les désactiver. Tout autre partenaire reçoit `PARTNER_CONTRACT_CANNOT_PROVISION` (ou `PARTNER_CANNOT_DEACTIVATE` à la désactivation). Un compte qui n'est pas un partenaire activé reçoit `PARTNER_ACCESS_REQUIRED`.

## Authentification

Envoyez votre clé `PARTNER` dans le header `Authorization`, sous la forme `Api-Key <votre-clé>` ou la clé seule. N'utilisez pas `Bearer <votre-clé>` : Allo lit une valeur `Bearer` comme un jeton de session utilisateur, et une API key envoyée ainsi renvoie `401`.

```bash
curl https://api.withallo.com/v2/api/partner/credit \
  -H "Authorization: Api-Key ak_live_your_key_here"
```

Voir [Authentification](/fr/docs/guides/authentication) pour le format du header et les scopes.

## Facturation

Chaque compte que vous créez a son propre abonnement au plan Business, qui vous est facturé selon la périodicité choisie (`MONTHLY` ou `YEARLY`). Allo débite la période complète à la création du compte, avec votre remise partenaire appliquée. Il n'y a pas de prorata. Allo ne facture jamais votre client : vous facturez vos clients vous-même.

Tous les montants partenaires se paient de la même façon : nouveaux comptes, renouvellements, numéros supplémentaires, sièges des membres et eSIM.

1. Allo prélève d'abord votre [crédit prépayé](/fr/docs/partner/get-credit).
2. Si le crédit ne couvre pas tout le montant, Allo débite le reste sur la carte de votre compte de facturation.
3. Si le crédit ne couvre pas le montant et qu'aucune carte n'est enregistrée, la requête échoue avec `402 PARTNER_CREDIT_INSUFFICIENT` et rien n'est créé.

Appelez [Obtenir le prix d'un compte](/fr/docs/partner/get-price) pour connaître le coût d'un nouveau compte avant de le créer, et [Obtenir le crédit prépayé](/fr/docs/partner/get-credit) pour vérifier votre solde.

## Endpoints

| Méthode | Chemin | Description |
|---------|--------|-------------|
| `GET` | `/v2/api/partner/accounts/price` | Obtenir le prix qu'Allo vous facturera pour un nouveau compte |
| `POST` | `/v2/api/partner/accounts` | Créer un compte, provisionner un numéro, renvoyer une clé dédiée |
| `GET` | `/v2/api/partner/accounts/{id}` | Obtenir le statut et l'état d'activation d'un compte |
| `DELETE` | `/v2/api/partner/accounts/{id}` | Désactiver un compte (résilie son abonnement, le compte fonctionne jusqu'à la fin de la période payée) |
| `GET` | `/v2/api/partner/credit` | Obtenir le solde de votre crédit prépayé et vos derniers rechargements |
