# Crédits

> Lister les packs de crédits, en acheter un par Stripe Checkout et comprendre quelles opérations de l'API débitent des crédits.

Certaines opérations de l'API consomment des [crédits](/v1.0/glossaire#crédit), prélevés sur le solde du client de l'appelant. Le solde se recharge en achetant un pack. La consultation du solde et de l'historique se fait dans la console : voir [Crédits](/v1.0/credits).

## Opérations qui consomment des crédits

| Opération | Endpoint | Coût par défaut |
|---|---|---|
| `SCAN_DOCUMENT` | `POST /api/antivirus/scans` | 1 crédit par fichier |
| `IMPORT_USERS` | `POST /api/import/users` | 2 crédits par import |
| `AI_TRANSLATE_SINGLE` | `POST /api/ai-translation/single` | 1 crédit |
| `AI_TRANSLATE_BULK` | `POST /api/ai-translation/bulk` | 5 crédits |
| `AI_TRANSLATE_MULTI` | `POST /api/ai-translation/bulk-multi` | 10 crédits |

Un coût peut être ajusté pour votre réseau ou votre client. Les crédits sont débités au moment de l'appel, avant le traitement. Si le solde est insuffisant, l'appel est refusé avec `402` `Insufficient credits` (pour l'antivirus, `402` `Antivirus service error`).

## Les packs

| Code | Crédits | Prix |
|---|---|---|
| `STARTER` | 100 | 9 € |
| `PRO` | 500 | 39 € |
| `BUSINESS` | 2 000 | 139 € |
| `ENTERPRISE` | 10 000 | 599 € |

## Lister les packs

::endpoint{method="GET" path="/api/pay/packs"}

**Accès** : tout appelant authentifié.

```bash
curl -s https://api.wakastart.app/api/pay/packs \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

**Réponse `200`**

```json
[
  {
    "name": "Pack Pro",
    "creditRatio": 500,
    "stripeProductId": "prod_Q1w2E3r4T5y6",
    "prices": [{ "stripePriceId": "price_1Q2w3E4r5T6y", "unitAmountCents": 3900, "currency": "eur" }]
  }
]
```

`creditRatio` est le nombre de crédits du pack.

## Acheter un pack

::endpoint{method="POST" path="/api/pay/packs/{packCode}/checkout-sessions"}

**Accès** : Administrateur client (`CUSTOMER_ADMIN`) au minimum. Le solde crédité est déduit de l'appelant : celui de son réseau s'il est Administrateur réseau ou plus et connecté par jeton, sinon celui de son client (toujours celui du client pour une clé API).

| Paramètre | Où | Type | Obligatoire | Contraintes |
|---|---|---|---|---|
| `packCode` | chemin | chaîne | oui | `STARTER`, `PRO`, `BUSINESS` ou `ENTERPRISE` |
| `successUrl` | corps | chaîne | oui | URL absolue, d'une origine autorisée par Wakastart |
| `cancelUrl` | corps | chaîne | oui | Idem |
| `idempotencyKey` | corps | chaîne | oui | 180 caractères au plus |
| `customerEmail` | corps | chaîne | non | E-mail de facturation |

```bash
curl -s -X POST https://api.wakastart.app/api/pay/packs/PRO/checkout-sessions \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "successUrl": "https://app.wakastart.app/credits?achat=ok",
    "cancelUrl": "https://app.wakastart.app/credits",
    "idempotencyKey": "achat-pro-2026-10-23-01"
  }'
```

**Réponse `201`**

```json
{ "id": "cs_test_b2C3d4E5f6G7", "url": "https://checkout.stripe.com/c/pay/cs_test_b2C3d4E5f6G7" }
```

Redirigez l'acheteur vers `url`. Le solde est crédité dès que Stripe confirme le paiement, en général quelques secondes après le retour sur `successUrl`.

**Erreurs**

| Statut | Message |
|---|---|
| `400` | `Pack inconnu : <code>. Valeurs attendues : STARTER, PRO, BUSINESS, ENTERPRISE` |
| `400` | `successUrl origin not allowed` (ou `cancelUrl`) |
| `403` | `Missing customer/network context for credit pack purchase` |
| `403` | `Niveau d'administration insuffisant. Requis: CustomerAdmin, Actuel: <niveau>` |
