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é.
- Accès requis
- Niveau Administrateur client, ou clé API de votre client
- Durée
- 5 min
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 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.
curl -s https://api.wakastart.app/api/pay/packs \
-H "x-api-key: sk_test_exemple"Réponse attendue (extrait) :
[
{
"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
- Choisissez le code du pack :
STARTER,PRO,BUSINESSouENTERPRISE. - Générez une clé d'idempotence pour cet achat, par exemple
recharge-2026-10-23-01. - Appelez
POST /api/pay/packs/{packCode}/checkout-sessions. Les URL de retour doivent pointer vers la console Wakastart,https://app.wakastart.app.
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"
}'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) :
{
"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
- Ouvrez l'
urldans un navigateur. - 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 vershttps://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.