Codes d'erreur
Un code d'erreur se présente sous la forme [PREFIXE]_[CODE] où:
[PREFIXE] | définit la couche applicative où l'erreur a eu lieu |
[CODE] | est le code numérique de l'erreur. |
Il existe différents préfixes :
PREFIXE | DESCRIPTION | EXEMPLE D'ERREUR |
---|---|---|
ACQ | Erreur du côté acquéreur | ACQ_001 |
AUTH | Erreur d'authentification | AUTH_149 |
CLIENT | Application JavaScript (sur le navigateur de l'acheteur) | CLIENT_003 |
INT | Erreur d'intégration (du côté du marchand) | INT_007 |
PSP | Erreur du côté PSP | PSP_001 |
Les erreurs sont renvoyées à travers 4 paramètres:
{ "errorCode": "INT_015", "errorMessage": "invalid customer email", "detailedErrorCode": null, "detailedErrorMessage": "Invalid input value [name=customer.email, value=fake-email]" }
PARAMETRE | TYPE DESCRIPTION | FORMAT | LONGUEUR Max |
---|---|---|---|
errorCode | chaine Code d'erreur (au format [PREFIXE]_[CODE]) | chaine | 7 |
errorMessage | chaine Message d'erreur | chaine | 127 |
detailedErrorCode | chaine Code d'erreur détaillé (ou null) | chaine | 127 |
detailedErrorMessage | chaine Message détaillé (ou null) | chaine | 127 |
Les codes d'erreur suivants sont décrits ici :
De nouveaux codes d'erreur peuvent être ajoutés dans le futur. Votre implémentation doit obligatoirement en tenir compte.