Erreurs de l’API Comptes
Les réponses d’erreur JSON de l’API Gestion des comptes comprennent des informations dans le corps de la réponse similaires à ce qui suit.
{
"error":{
"code":"8500",
"message":"The merchant name you submitted already exists.",
"links":[
{
"rel":"errorinfo",
"href":"https://developer.paysafe.com/en/rest-api/partners/account-management/test-and-go-live/account-management-errors#ErrorCode8500"
}
]
}
}
{
"error": {
"code": "5269",
"message": "The ID(s) specified in the URL do not correspond to the values in the system.",
"details": [
"Account id [{{accountNumber}}] does not exist"
],
"links": [
{
"rel": "errorinfo",
"href": "https://developer.paysafe.com/en/rest-api/partners/account-management/test-and-go-live/account-management-errors#ErrorCode5269"
}
]
}
}
L’objet error comporte les éléments suivants :
| Élément | Type | Description | Requis? | |
|---|---|---|---|---|
| code | string | Le code d’erreur Également affiché dans l’en-tête de réponse X-Application-Status-Code. | Oui | |
| message | string | Le message d’erreur qui décrit l’erreur. | Oui | |
| details | tableau de chaînes | Détails de toute erreur de valeur de paramètre dans le corps de la requête. | Facultatif | |
links | rel | string | Le type de lien : "errorinfo". | Oui |
| href | string | L’URL du Centre des développeurs qui contient une description de l’erreur. | Oui | |
Pour vous éviter d’avoir à analyser le corps de la réponse pour trouver les informations d’erreur, vous pouvez récupérer le code d’erreur à partir de l’en-tête de réponse X-Application-Status-Code.
Il s’agit d’un résumé de toutes les erreurs susceptibles d’être renvoyées lors de l’utilisation de l’API Paiements par carte, 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 votre identifiant/mot de passe de 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 | 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) que la ressource ne prend pas en charge. |
| 400 | 5501 | Le profil ne comporte pas de carte de crédit active. |
| 400 | 5500 | Soit le jeton de paiement n’est pas valide, soit le profil ou le compte bancaire correspondant n’est pas actif. |
Erreurs de gestion de comptes
| Code d’état HTTP | Code d’erreur | Description |
|---|---|---|
| 400 | 8500 | Nom du marchand déjà utilisé. |
| 400 | 8501 | Nom du compte déjà utilisé. |
| 400 | 8502 | Nom légal déjà utilisé. |
| 400 | 8503 | L’adresse du compte existe déjà. |
| 400 | 8504 | L’adresse actuelle du propriétaire de l’entreprise existe déjà. |
| 400 | 8505 | L’adresse antérieure a déjà été ajoutée à ce propriétaire d’entreprise. |
| 400 | 8506 | Une pièce d’identité a déjà été attribuée à ce propriétaire d’entreprise. |
| 400 | 8507 | Le type de pièce d’identité fourni n’est pas pris en charge pour cette région. |
| 400 | 8508 | Les conditions générales ont déjà été acceptées. |
| 400 | 8509 | La requête d’activation de compte que vous avez soumise est incomplète. |
| 400 | 8510 | La requête d’activation de compte que vous avez soumise n’est pas valide. |
| 400 | 8511 | L’état du compte n’est pas valide. |
| 400 | 8512 | Il existe déjà un compte bancaire associé à l’identifiant de compte fourni. |
| 400 | 8513 | Votre compte bancaire ne peut être validé. Veuillez contacter le soutien technique. |
| 400 | 8514 | Le micro-dépôt a déjà été versé sur le compte bancaire. |
| 400 | 8515 | La pièce d’identité est déjà associée à un compte marchand. |
| 400 | 8516 | La pièce d’identité n’a pas l’état requis pour être enregistrée. |
| 403 | 8520 | Le partenaire n’est pas configuré pour exécuter cette opération. |
| 400 | 8521 | Les options et/ou l’état de la transaction du compte n’ont pas pu être mis à jour. |
| 400 | 8522 | Une erreur s’est produite lors de la configuration de votre compte marchand. Le champ amexMid ne peut pas être utilisé pour la configuration actuelle du partenaire. |