Codes d'erreur

L’API retourne un code HTTP et un objet JSON contenant généralement un champ message. Certains endpoints plus anciens utilisent errors.

Authentification et en-têtes

HTTP	Message actuel	Correction
400	Bad Request: Missing params	Envoyer les quatre en-têtes obligatoires.
400	Bad Request: Not Allowed Environment	Utiliser sandbox ou live.
400	Bad Request: Not Allowed Payment Type	Choisir un type pris en charge par le compte et l’environnement.
400	Bad Request: Missing Authentication Key	Utiliser Authorization: Bearer <cle>.
401	Unauthorized: No Valid Key	Vérifier la clé et l’environnement associé.
403	Forbidden: Environment Not Available	Vérifier la validation et la disponibilité du compte.
406	Not Acceptable: Invalid Content Type	Envoyer exactement Content-Type: application/json.

Création d’un paiement

HTTP	Message actuel	Correction
400	Bad Request: Missing Body Params	Ajouter les champs obligatoires.
400	Bad Request: Country Not Allowed	Utiliser BJ ou NE pour le contrat standard.
400	Bad Request: Currency Not Allowed	Utiliser XOF.
400	Bad Request: Amount Not Valid	Respecter le montant minimum du moyen choisi.
400	Bad Request: Incorrect MSISDN	Utiliser un numéro au format attendu pour le pays ou un numéro Sandbox.
400	Bad Request: Missing MyNita Account	Vérifier le compte MyNita du payeur.
403	Contact le support: [e-mail]	Le compte n’est pas actif pour cette opération.
422	External Reference Not Valid	Générer un transaction_id unique pour le compte.
422	Unprocessable Entity	Vérifier les validations de la requête et contacter le support avec les références.

Consultation

HTTP	Message actuel	Signification
404	Payment Not Found	La référence n’existe pas pour le compte authentifié.
404	External payment not found	Le lien de paiement demandé n’existe pas.

Traitement recommandé

• Ne relancez pas automatiquement une erreur 400, 401, 403, 404, 406 ou 422 sans corriger la requête.
• Pour une erreur serveur ou réseau, conservez la même référence externe et vérifiez d’abord si le paiement existe avant de retenter une création.
• Journalisez le code HTTP, le message, transaction_id et la référence iPayMoney, jamais les clés ni les données de carte.