Codes d'erreur

Les erreurs sont signalées par le code HTTP et un message lisible (error). 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
403	Refusé : action impossible avec une clé de test (test_mode : liens de paiement), ou clé de production d’un espace dont l’identité n’est pas encore vérifiée (identity_unverified)
404	Session ou lien 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.