# Acheter un pack de crédits

> Lister les packs, créer une session de paiement Stripe pour l'un d'eux et vérifier que le solde a été crédité.

Les crédits s'achètent par packs, payés par carte sur une page Stripe. Ce guide passe par l'API publique : vous créez une session de paiement, vous la payez, puis Wakastart crédite votre solde automatiquement.

## Avant de commencer

- Vous disposez d'une [clé API](/v1.0/glossaire#clé-api) de votre client, ou du jeton d'un Administrateur client. Les exemples utilisent une clé API en `x-api-key`.
- Le solde crédité est déterminé par l'appelant. Une clé API ou le jeton d'un Administrateur client crédite **le solde du client**, celui que consomment vos applications. Le jeton d'un Administrateur réseau, d'un Administrateur d'applications ou d'un Propriétaire crédite le solde du **réseau**, que vos applications ne consomment pas : pour recharger vos applications, utilisez une clé API ou un compte Administrateur client.

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

## Lister les packs disponibles

Appelez `GET /api/pay/packs` pour obtenir les packs en vente et leur prix actuel.

```bash
curl -s https://api.wakastart.app/api/pay/packs \
  -H "x-api-key: sk_test_exemple"
```

Réponse attendue (extrait) :

```json
[
  {
    "name": "Pack Starter",
    "creditRatio": 100,
    "stripeProductId": "prod_Exemple1",
    "prices": [{ "stripePriceId": "price_Exemple1", "unitAmountCents": 900, "currency": "eur" }]
  },
  {
    "name": "Pack Pro",
    "creditRatio": 500,
    "stripeProductId": "prod_Exemple2",
    "prices": [{ "stripePriceId": "price_Exemple2", "unitAmountCents": 3900, "currency": "eur" }]
  }
]
```

`creditRatio` est le nombre de crédits ajoutés par pack acheté.

## Créer la session de paiement

1. Choisissez le code du pack : `STARTER`, `PRO`, `BUSINESS` ou `ENTERPRISE`.
2. Générez une clé d'idempotence pour cet achat, par exemple `recharge-2026-10-23-01`.
3. Appelez `POST /api/pay/packs/{packCode}/checkout-sessions`. Les URL de retour doivent pointer vers la console Wakastart, `https://app.wakastart.app`.

::::tabs{sync="lang"}
:::tab{label="cURL"}
```bash
curl -s -X POST https://api.wakastart.app/api/pay/packs/PRO/checkout-sessions \
  -H "x-api-key: sk_test_exemple" \
  -H "Content-Type: application/json" \
  -d '{
    "successUrl": "https://app.wakastart.app/credits",
    "cancelUrl": "https://app.wakastart.app/credits",
    "idempotencyKey": "recharge-2026-10-23-01",
    "customerEmail": "compta@mon-entreprise.exemple.fr"
  }'
```
:::
:::tab{label="TypeScript"}
```ts
const response = await fetch(
  "https://api.wakastart.app/api/pay/packs/PRO/checkout-sessions",
  {
    method: "POST",
    headers: {
      "x-api-key": process.env.WAKASTART_API_KEY!,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      successUrl: "https://app.wakastart.app/credits",
      cancelUrl: "https://app.wakastart.app/credits",
      idempotencyKey: "recharge-2026-10-23-01",
    }),
  },
);
if (!response.ok) throw new Error((await response.json()).message);
const { url } = (await response.json()) as { id: string; url: string };
console.log(`Payer ici : ${url}`);
```
:::
::::

Réponse attendue (`201`) :

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

Le corps n'accepte ni montant, ni nombre de crédits, ni organisation : ils viennent du catalogue de packs et de votre identité. Rejouer le même corps avec la même `idempotencyKey` renvoie la même session.

## Payer et revenir sur la console

1. Ouvrez l'`url` dans un navigateur.
2. Payez sur la page Stripe.

Résultat : Stripe vous renvoie sur `successUrl`, la page des crédits de la console. Le solde est crédité dès que Wakastart reçoit la confirmation de Stripe, en général en quelques secondes.

## Vérifier le résultat

Dans la console, ouvrez **Modules** > **Tableau de Bord** : **Solde actuel** et **Total rechargé** ont augmenté de 500 crédits, et une transaction **Crédit** apparaît dans **Dernières transactions**.

## Dépannage

- `400` « Pack inconnu : … » : le code n'est pas l'un des quatre codes, en majuscules.
- `400` « successUrl origin not allowed » : l'URL de retour ne pointe pas vers `https://app.wakastart.app`.
- `403` « Missing customer/network context for credit pack purchase » : la clé ou le compte n'est rattaché à aucun client.
- Autres cas : [Résoudre les problèmes de crédits](/v1.0/credits/depannage).

## Voir aussi

- [Soldes et transactions](/v1.0/credits/soldes-et-transactions)
- [Référence API : crédits](/v1.0/reference-api/credits)
