Erreurs 3D Secure 2
Les réponses d’erreur JSON de l’API 3D Secure 2 comprennent des informations dans le corps de la réponse similaires à ce qui suit :
{
"error": {
"code": "5068",
"message": "Field Error(s)",
"details": [
"Either you submitted a request that is missing a mandatory field or the value of a field does not match the format expected."
],
"fieldErrors": [{
"field": "email",
"error": "john@hi@you.c.c.c.c is not a valid email address."
}, {
"field": "amount",
"error": "An amount is required."
}]
}
}
L’objet error comporte les éléments suivants :
| Élément | Type | Description |
|---|---|---|
| code | string | Il s’agit du code d’erreur. Également affiché dans l’en-tête de réponse X-Application-Erreur. |
| message | string | Le message d’erreur qui décrit l’erreur. |
| details | string | Il s’agit d’un recueil de descriptions détaillées. |
| fieldErrors.field | string | Identifie le champ de la requête JSON. |
| fieldErrors.error | string | Il s’agit du problème lié au champ. |
Pour vous éviter d’avoir à analyser le corps de la réponse pour trouver les informations d’erreur, vous pouvez récupérer le message d’erreur à partir de l’en-tête de réponse X-Application-Error.
Il s’agit d’un résumé de toutes les erreurs susceptibles d’être renvoyées lors de l’utilisation de l’API 3D Secure, y compris les codes d’état HTTP.
Résumé des code d’état HTTP
| Plage de code | Description |
|---|---|
| 1xx: Informational | Communique des informations au niveau du protocole de transfert. |
| 2xx: Success | Indique que la demande du client a été acceptée. |
| 3xx: Redirection | Indique que le client doit effectuer une action supplémentaire pour terminer la demande. |
| 4xx: Client Error | Indique que le client a commis une erreur dans la demande. |
| 5xx: Server Error | Indique qu’une erreur s’est produite du côté du serveur |
Codes d’état de réponse HTTP courants
| Code | Description |
|---|---|
| 200 OK | Tout a fonctionné comme prévu. |
| 201 Created | La requête a réussi. Paysafe a créé une nouvelle ressource, et le corps de la réponse contient la représentation. |
| 202 Accepted | Ceci indique que la demande du client sera traitée de manière asynchrone. Indique au client que la demande semble valide, mais qu’elle peut encore poser des problèmes une fois traitée. |
| 204 No Content | Généralement renvoyé en réponse à une requête PUT, POST ou DELETE lorsque l’API REST refuse de renvoyer un message d’état ou une représentation dans le corps du message de réponse. |
| 304 Not Modified | La version de la représentation mise en cache par le client est toujours à jour. |
| 400 Bad Request | Indique souvent qu’un paramètre requis est manquant ou qu’un paramètre n’est pas valide. Il s’agit d’un état d’erreur générique côté client, utilisé lorsqu’aucun autre code d’erreur 4xx n’est approprié. |
| 401 Unauthorized | Indique que le client a essayé de mener une activité sur une ressource protégée sans fournir l’autorisation appropriée. Il se peut qu’il ait fourni les mauvaises références ou qu’il n’en ait pas fourni du tout. |
| 402 Payment Required | Les paramètres étaient valides mais la requête a échoué. |
| 404 Not Found | La ressource demandée n’existe pas. |
| 405 Method Not Allowed | Le client a essayé de lancer POST ou PUT vers une ressource qui ne l’accepte pas. |
| 415 Unsupported Media Type | La requête est dans un format qui n’est pas pris en charge par la ressource demandée pour la méthode demandée. |
| 429 Too Many Requests | L’application envoie trop de requêtes simultanées. |
| 500 Internal Server Error | Une erreur s’est produite avec un serveur interne. |
| 502 External Server Error | Nous avons reçu une réponse non valide de la passerelle en amont en essayant de répondre à la requête. |
Erreurs courantes
| Code d’état HTTP | Code d’erreur | Description |
|---|---|---|
| 500 | 1000 | Une erreur interne s’est produite. |
| 502 | 1001 | Une erreur s’est produite avec la passerelle de sous-traitance. |
| 500 | 1002 | Une erreur interne s’est produite. |
| 500 | 1003 | Une erreur interne s’est produite. |
| 500 | 1007 | Une erreur interne s’est produite. |
| 500 | 1008 | Une erreur interne s’est produite. |
| 429 | 1200 | L’appel API a été refusé car il a dépassé la limite du nombre d’appels autorisé. |
| 401 | 5000 | L’authentification de votre compte marchand a échoué. Soit l’identifiant/mot de passe de votre magasin n’est pas valide, soit l’adresse IP à partir de laquelle vous envoyez la transaction n’a pas été autorisée. |
| 400 | 5001 | Le code de devise soumis n’est pas valide ou votre compte ne prend pas en charge cette devise. |
| 400 | 5003 | Vous avez soumis un montant non valide avec votre requête. |
| 400 | 5004 | Vous avez soumis un type de compte non valide avec votre requête. |
| 400 | 5005 | Vous avez soumis un type d’opération non valide avec votre requête. |
| 400 | 5010 | Le code de pays soumis n’est pas valide. |
| 400 | 5016 | Le compte marchand que vous avez fourni est introuvable. |
| 400 | 5017 | Le compte marchand que vous avez fourni est désactivé. |
| 402 | 5021 | Votre requête de transaction a été refusée. |
| 400 | 5023 | La requête ne peut être interprétée. |
| 409 | 5031 | La transaction que vous avez soumise a déjà été traitée. |
| 401 | 5040 | Votre compte marchand n’est pas configuré pour la transaction que vous avez tenté d’effectuer. |
| 400 | 5042 | Le numéro de référence du marchand est manquant, non valide ou dépasse la longueur maximale autorisée. |
| 400 | 5050 | Le type de carte n’est pas pris en charge. |
| 400 | 5068 | Soit vous avez soumis une requête pour laquelle il manque un champ obligatoire, soit la valeur d’un champ ne correspond pas au format attendu. |
| 404 | 5269 | Le ou les identifiants spécifiés dans l’URL ne correspondent pas aux valeurs du système. |
| 403 | 5270 | Les authentifiants fournis avec la requête ne permettent pas d’accéder aux données demandées. |
| 406 | 5271 | Vous avez demandé une réponse dans l’en-tête ‘Accept’ qui est dans un format non pris en charge. |
| 406 | 5272 | Le type de contenu ‘Content-Type’ que vous avez spécifié dans l’en-tête de la requête a été soumis dans un format non pris en charge. |
| 404 | 5273 | Votre client a accédé à notre application, mais nous n’avons pas pu répondre à votre requête en raison d’une URL non valide. |
| 401 | 5275 | Les authentifiants fournis avec la requête ont expiré. |
| 401 | 5276 | Les authentifiants fournis avec la requête ont été désactivés. |
| 401 | 5277 | Les authentifiants fournis avec la requête ont été verrouillés en raison de plusieurs échecs d’authentification. |
| 401 | 5278 | Les authentifiants fournis avec la requête n’ont pas été acceptés pour une raison inconnue. |
| 401 | 5279 | Les authentifiants ne sont pas valides. |
| 401 | 5280 | Les authentifiants requis n’ont pas été fournis. |
| 405 | 5281 | La requête utilise une action (p. ex. GET, POST ou PUT, etc.) qui n’est pas prise en charge par la ressource. |
| 400 | 5502 | Soit le jeton de paiement n’est pas valide, soit le profil ou le compte bancaire correspondant n’est pas actif. |