Aller au contenu principal

Code de réponses

L'API de paiement Mobile Money de Chipdeals utilise des codes de réponse HTTP conventionnels pour indiquer le succès ou l'échec des requêtes.

Nous discutons ci-dessous de certaines erreurs courantes et de leurs causes.

Mauvaise requête

Status Code de l'entête : 400
Le serveur ne peut pas traiter la demande en raison d'une erreur dans la requête. Par exemple, une erreur dans les données passées à la requête ou une URL de requête non-existante.

Requête Non Autorisée

Status Code de l'entête : 401
Identifiants d'authentification invalides. La clé API utilisée dans la requête est invalide.

Requête interdite

Status Code de l'entête : 403
Votre demande contient des données valides et a été comprise par le serveur. Mais l'action demandée n'est pas possible. Cela peut être dû au fait que vous ne disposez pas des autorisations nécessaires pour la demande que vous faites.

Il peut aussi s'agir d'une action impossible à réaliser. Par exemple, faire un virement de fonds avec un solde inférieur à la somme que vous essayez d'envoyer.

Resource demandée non trouvée

Status Code de l'entête : 404
La ressource demandée est introuvable. Par exemple une transaction avec une référence inexistante.

Erreur du serveur

Status Code de l'entête : 500
Un message d'erreur générique. Cette erreur survient lorsqu'une condition inattendue a été rencontrée sur notre serveur et qu'aucun message plus spécifique n'est approprié.


Codes de l'état des transactions

Lorsque vous initiez un paiement, ou essayez de vérifier l'état d'un paiement, nous vous renvoyons un objet contenant les détails du paiement. La propriété statusMessageCode présent dans le corps de la réponse permet de déterminer avec précision l'état actuel d'un paiement

Code Etat Signification
200successTransaction Effectuée avec succès
201pendingValidation des informations de transaction en cours
202processingTransaction en cours de traitement
203pendingInformations de paiement valides
204pendingEn attente de validation du paiement par l'utilisateur
400errorInformations de transaction invalides
401errorInformations de transaction incomplètes
402errorNuméro de reception du paiement invalide
403errorNuméro du bénéficiaire invalide
404errorPaiement non approuvé par le payeur
406errorNuméro non relié à un compte mobile money
407errorValidation de paiement déjà en attente sur ce compte
408errorUne transaction du même montant sur ce compte est déjà en cours.
409errorLe bénéficiaire a atteint le montant maximum recevable autorisé par mois sur ce compte.
410errorLe montant que vous avez saisi dans la demande est inférieur au minimum requis
411errorLe montant que vous avez saisi dans la demande est supérieur au maximum autorisé
413errorLe maximum de paiements échoués autorisé est atteint. Exécutez à nouveau la transaction au bout d'un délais de 24h
414errorCette carte bancaire ne dispose pas de l'authentification 3DS activée.
460errorCe compte ne dispose pas d'assez de fond pour effectuer le paiement.
461errorUne erreur s'est produite lors du paiement
462errorNous ne supportons pas encore des transaction avec cet opérateur Mobile Money.
462errorNous ne supportons pas encore des transactions pour ce pays.
5XXerrorUne erreur s'est produite sur le serveur. Nos développeurs sont au courant. Nous y remédions.
505errorUne erreur s'est produite avec l'opérateur réseau lors de l'exécution de la transaction.

Codes d'erreurs

Ici nous listons les codes d'erreur possibles lors de vos requêtes vers l'API.

Un code d'erreur est présent dans une réponse lorsqu'une erreur s'est produite pendant le traitement de la requête.

Exemple
{
"success": false,
"message": "Endpoint not available",
"errorCode": "400-000" // code d'erreur
}
Code Status Code d'entête Signification
400-000400URL inexistant
400-001400Certaines données que vous avez envoyées ne sont pas correctes
400-100400Paramètre senderFirstName introuvable dans la requête
400-101400Le paramètre senderFirstName contient une donnée non valide
400-102400Paramètre senderLastName introuvable dans la requête
400-103400Le paramètre senderLastName contient une donnée non valide
400-104400Paramètre senderPhoneNumber introuvable dans la requête
400-105400Le paramètre senderPhoneNumber contient des données invalides
400-106400Paramètre amount introuvable dans la requête
400-107400Le paramètre amount contient une donnée non valide
400-110400Paramètre recipientPhoneNumber introuvable dans la requête
400-111400Le paramètre recipientPhoneNumber contient une donnée non valide
400-116400Devise demandée non prise en charge
400-117400Le paramètre currency est introuvable dans la requête
400-118400Le paramètre currency contient une donnée non valide
400-120400Le code pays de l'expéditeur phoneNumber n'est pas activé avec votre clé API
400-121400Le code pays du numéro de téléphone du destinataire n'est pas activé avec votre clé API
400-122400Opérateur réseau du payeur incorrect
400-123400Opérateur réseau du destinataire incorrect
400-124400L'opérateur du numéro de téléphone de l'expéditeur n'est pas encore pris en charge
400-125400L'opérateur du numéro de téléphone du destinataire n'est pas encore pris en charge
400-129400Pays non pris en charge
401-100401Clé API incorrecte
404-100404Aucune transaction portant cette référence trouvée
403-100403Solde insuffisant pour faire un paiement
500-000500Erreur serveur
500-001500Une erreur s'est produite lors de la conversion des devises.