Codes d'erreur

Les erreurs sont signalées par le code HTTP et un message lisible (error). Les transferts, le rejeu des webhooks et le mode test ajoutent un champ code stable (test_mode, rate_limited, solde_insuffisant…).

Code	Signification
400	Paramètre manquant ou invalide (amount absent, webhookUrl non publique, lien incomplet…)
401	Clé API absente ou invalide : Missing API key ou Invalid API Key
402	Solde insuffisant pour un transfert (solde_insuffisant)
403	Refusé : passerelle d’une autre application, action impossible avec une clé de test (test_mode : transferts, liens de paiement), ou clé de production d’un espace dont l’identité n’est pas encore vérifiée (identity_unverified)
404	Session, lien ou passerelle introuvable
409	La session n’est plus payable (déjà annulée ou remboursée)
429	Trop de requêtes : respectez l’en-tête Retry-After (secondes)
500	Erreur interne : réessayez, puis contactez-nous si elle persiste
502	L’agrégateur n’a pas pu initier le paiement : le message contient sa réponse

Exemple

{ "error": "amount is required and must be > 0" }

Les endpoints de la page de paiement (/checkout/initiate, /checkout/verify) répondent { "success": false, "message": "..." }. Ils sont utilisés par la page hébergée et n’ont pas besoin d’être appelés directement.