Erreurs

Toute erreur a la même forme, avec un code HTTP cohérent :

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Solde insuffisant.",
    "request_id": "req_4f8a1c2e9b7d6a05"
  }
}

Champ	Type	Description
`code`	texte	Stable, en majuscules : c’est lui que votre programme doit tester.
`message`	texte	Une phrase en français, lisible par une personne. Peut évoluer.
`request_id`	texte	L’identifiant de la requête, aussi présent dans l’en-tête `X-Request-Id` et dans vos logs. Donnez-le au support.

Que faire selon le code HTTP

Champ	Type	Description
`400, 402, 403, 404, 409`	—	La requête ne passera pas telle quelle : corrigez-la. Ne la rejouez pas en boucle.
`401`	—	Vérifiez la clé. Après plusieurs échecs, l’adresse est bloquée dix minutes.
`429`	—	Attendez le nombre de secondes indiqué par l’en-tête `Retry-After`.
`500, 503`	—	Réessayez après une pause croissante (1 s, 2 s, 4 s…), avec la même `Idempotency-Key`.

Tous les codes

Code	HTTP	Signification
`AUTHENTICATION_REQUIRED`	401	Clé API manquante.
`INVALID_API_KEY`	401	Clé API invalide.
`API_KEY_REVOKED`	401	Clé révoquée.
`INSUFFICIENT_SCOPE`	403	La clé n’a pas la permission requise.
`SECRET_KEY_REQUIRED`	403	Une clé secrète est nécessaire.
`LICENSE_REQUIRED`	403	Aucune licence active sur le compte.
`ACCOUNT_SUSPENDED`	403	Compte suspendu.
`PROJECT_SUSPENDED`	403	Projet suspendu ou inactif.
`PROJECT_RESTRICTED`	403	Retraits restreints sur ce projet.
`WITHDRAWALS_BLOCKED`	403	Retraits bloqués sur ce compte.
`PLAN_LIMIT_REACHED`	403	Limite de projets de la licence atteinte.
`INVALID_REQUEST`	400	Champ manquant ou invalide (le message dit lequel).
`INVALID_JSON`	400	Corps de requête illisible.
`INVALID_AMOUNT`	400	Le montant doit être un entier de gourdes, supérieur à zéro.
`AMOUNT_TOO_LOW`	400	Montant inférieur au minimum.
`AMOUNT_TOO_HIGH`	400	Montant supérieur au maximum.
`INVALID_PHONE`	400	Numéro invalide.
`INVALID_NAME`	400	Nom invalide.
`INVALID_WALLET`	400	Portefeuille inconnu.
`INVALID_EVENT`	400	Événement de webhook inconnu.
`URL_NOT_ALLOWED`	400	Adresse refusée : https publique uniquement.
`IDEMPOTENCY_KEY_REQUIRED`	400	En-tête Idempotency-Key obligatoire.
`INSUFFICIENT_BALANCE`	402	Solde insuffisant.
`NOT_FOUND`	404	Adresse inconnue.
`PAYMENT_NOT_FOUND`	404	Paiement introuvable dans ce projet.
`WITHDRAWAL_NOT_FOUND`	404	Retrait introuvable dans ce projet.
`TRANSACTION_NOT_FOUND`	404	Transaction introuvable.
`PROJECT_NOT_FOUND`	404	Projet introuvable.
`WEBHOOK_NOT_FOUND`	404	Webhook introuvable.
`METHOD_NOT_ALLOWED`	405	Méthode non autorisée pour cette adresse.
`IDEMPOTENCY_CONFLICT`	409	Même clé d’idempotence, contenu différent.
`REQUEST_IN_PROGRESS`	409	La même requête est déjà en cours.
`REFERENCE_ALREADY_USED`	409	Cette référence a déjà servi.
`TOO_MANY_OPEN_WITHDRAWALS`	409	Trop de retraits en cours.
`NAME_ALREADY_USED`	409	Un projet porte déjà ce nom.
`WEBHOOK_ALREADY_EXISTS`	409	Adresse déjà enregistrée pour ce projet.
`WEBHOOK_LIMIT_REACHED`	409	Trois webhooks au plus par projet.
`PAYLOAD_TOO_LARGE`	413	Corps de requête trop volumineux (64 Ko au plus).
`UNSUPPORTED_MEDIA_TYPE`	415	Le corps doit être en JSON.
`RATE_LIMITED`	429	Trop de requêtes.
`TOO_MANY_FAILED_ATTEMPTS`	429	Trop de clés invalides depuis cette adresse.
`INTERNAL_ERROR`	500	Erreur de notre côté. Donnez le request_id au support.
`SERVICE_PAUSED`	503	Service temporairement indisponible.
`PAYMENTS_PAUSED`	503	Paiements temporairement suspendus.
`WITHDRAWALS_PAUSED`	503	Retraits temporairement suspendus.
`API_WRITES_PAUSED`	503	Écritures par API temporairement suspendues.
`SERVICE_UNAVAILABLE`	503	Service temporairement indisponible : réessayez.

← Webhooks Limites de débit →

Une question sur l’intégration ?