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, 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.
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
/api/pay/packsAccès : tout appelant authentifié.
curl -s https://api.wakastart.app/api/pay/packs \
-H "Authorization: Bearer $ACCESS_TOKEN"Réponse 200
[
{
"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
/api/pay/packs/{packCode}/checkout-sessionsAccè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 |
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
{ "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> |