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 |
---|---|---|
200 | success | Transaction Effectuée avec succès |
201 | pending | Validation des informations de transaction en cours |
202 | processing | Transaction en cours de traitement |
203 | pending | Informations de paiement valides |
204 | pending | En attente de validation du paiement par l'utilisateur |
400 | error | Informations de transaction invalides |
401 | error | Informations de transaction incomplètes |
402 | error | Numéro de reception du paiement invalide |
403 | error | Numéro du bénéficiaire invalide |
404 | error | Paiement non approuvé par le payeur |
406 | error | Numéro non relié à un compte mobile money |
407 | error | Validation de paiement déjà en attente sur ce compte |
408 | error | Une transaction du même montant sur ce compte est déjà en cours. |
409 | error | Le bénéficiaire a atteint le montant maximum recevable autorisé par mois sur ce compte. |
410 | error | Le montant que vous avez saisi dans la demande est inférieur au minimum requis |
411 | error | Le montant que vous avez saisi dans la demande est supérieur au maximum autorisé |
413 | error | Le maximum de paiements échoués autorisé est atteint. Exécutez à nouveau la transaction au bout d'un délais de 24h |
414 | error | Cette carte bancaire ne dispose pas de l'authentification 3DS activée. |
460 | error | Ce compte ne dispose pas d'assez de fond pour effectuer le paiement. |
461 | error | Une erreur s'est produite lors du paiement |
462 | error | Nous ne supportons pas encore des transaction avec cet opérateur Mobile Money. |
462 | error | Nous ne supportons pas encore des transactions pour ce pays. |
5XX | error | Une erreur s'est produite sur le serveur. Nos développeurs sont au courant. Nous y remédions. |
505 | error | Une 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.
{
"success": false,
"message": "Endpoint not available",
"errorCode": "400-000" // code d'erreur
}
Code | Status Code d'entête | Signification |
---|---|---|
400-000 | 400 | URL inexistant |
400-001 | 400 | Certaines données que vous avez envoyées ne sont pas correctes |
400-100 | 400 | Paramètre senderFirstName introuvable dans la requête |
400-101 | 400 | Le paramètre senderFirstName contient une donnée non valide |
400-102 | 400 | Paramètre senderLastName introuvable dans la requête |
400-103 | 400 | Le paramètre senderLastName contient une donnée non valide |
400-104 | 400 | Paramètre senderPhoneNumber introuvable dans la requête |
400-105 | 400 | Le paramètre senderPhoneNumber contient des données invalides |
400-106 | 400 | Paramètre amount introuvable dans la requête |
400-107 | 400 | Le paramètre amount contient une donnée non valide |
400-110 | 400 | Paramètre recipientPhoneNumber introuvable dans la requête |
400-111 | 400 | Le paramètre recipientPhoneNumber contient une donnée non valide |
400-116 | 400 | Devise demandée non prise en charge |
400-117 | 400 | Le paramètre currency est introuvable dans la requête |
400-118 | 400 | Le paramètre currency contient une donnée non valide |
400-120 | 400 | Le code pays de l'expéditeur phoneNumber n'est pas activé avec votre clé API |
400-121 | 400 | Le code pays du numéro de téléphone du destinataire n'est pas activé avec votre clé API |
400-122 | 400 | Opérateur réseau du payeur incorrect |
400-123 | 400 | Opérateur réseau du destinataire incorrect |
400-124 | 400 | L'opérateur du numéro de téléphone de l'expéditeur n'est pas encore pris en charge |
400-125 | 400 | L'opérateur du numéro de téléphone du destinataire n'est pas encore pris en charge |
400-129 | 400 | Pays non pris en charge |
401-100 | 401 | Clé API incorrecte |
404-100 | 404 | Aucune transaction portant cette référence trouvée |
403-100 | 403 | Solde insuffisant pour faire un paiement |
500-000 | 500 | Erreur serveur |
500-001 | 500 | Une erreur s'est produite lors de la conversion des devises. |