Aller au contenu

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.

RéférenceDéveloppeurAdministrateur
Voir en Markdown

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érationEndpointCoût par défaut
SCAN_DOCUMENTPOST /api/antivirus/scans1 crédit par fichier
IMPORT_USERSPOST /api/import/users2 crédits par import
AI_TRANSLATE_SINGLEPOST /api/ai-translation/single1 crédit
AI_TRANSLATE_BULKPOST /api/ai-translation/bulk5 crédits
AI_TRANSLATE_MULTIPOST /api/ai-translation/bulk-multi10 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

CodeCréditsPrix
STARTER1009 €
PRO50039 €
BUSINESS2 000139 €
ENTERPRISE10 000599 €

Lister les packs

GET/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

POST/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ètreOùTypeObligatoireContraintes
packCodecheminchaîneouiSTARTER, PRO, BUSINESS ou ENTERPRISE
successUrlcorpschaîneouiURL absolue, d'une origine autorisée par Wakastart
cancelUrlcorpschaîneouiIdem
idempotencyKeycorpschaîneoui180 caractères au plus
customerEmailcorpschaînenonE-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

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