Crédits et facturation

ExtentAPI fonctionne au crédit prépayé. Pas d’abonnement, pas d’engagement, pas de carte en bout de mois — vous rechargez, vous consommez, votre solde diminue.

Conversion

Unité	Valeur
1 crédit	1 € HT
Granularité	3 décimales (0,001 crédit minimum)

Les montants s’expriment en crédits décimaux (jusqu’à trois chiffres après la virgule), ce qui couvre les appels très bon marché sans arrondi gênant (ex. un check email à 0,002 crédit).

Comment ça se passe

Recharge initiale — l’équipe ExtentAPI alloue manuellement votre solde (V1). Vous recevez la confirmation par email avec le montant en crédits + l’équivalent en €.
Admission & réservation — avant chaque appel facturable, le service vérifie que votre solde disponible couvre le coût estimé puis réserve ce montant (pré-autorisation). Si le disponible est insuffisant, vous recevez un 402 insufficient_credit. La réservation garantit qu’une rafale d’appels simultanés ne peut pas dépasser votre solde.
Règlement — à la fin de l’opération, le coût réel est débité et la réservation libérée (le réel est souvent inférieur à l’estimé). Si l’opération échoue, la réservation est libérée sans débit. Le solde disponible se reflète dans la seconde.
Ledger immuable — chaque mouvement (allocation, débit, ajustement) est consigné. Vous pouvez lister les 20 dernières transactions via GET /v1/billing/me/transactions.

Surface API

# Solde courant
curl https://orchestrator.extentapi.example/v1/billing/me \
  -H "x-api-key: ek_live_..."

# Transactions paginées
curl https://orchestrator.extentapi.example/v1/billing/me/transactions \
  -H "x-api-key: ek_live_..."

# Plan + addons en cours
curl https://orchestrator.extentapi.example/v1/billing/me/subscription \
  -H "x-api-key: ek_live_..."

Recharge

En V1, la recharge est manuelle, sur demande à l’équipe ExtentAPI. Versement par virement SEPA ou carte (via lien de paiement Stripe envoyé par email).

Le paiement automatique (recharge à seuil, abonnement de recharge mensuelle) est planifié pour une release ultérieure.

Mode metered vs unmetered

Metered (par défaut) — chaque appel décompté.
Unmetered — pour les comptes avec contrat forfaitaire, paramétré par l’équipe ExtentAPI.