Erreurs de prélèvement automatique
Les réponses d’erreur JSON de l’API Prélèvement automatique comprennent des informations dans le corps de la réponse similaires à ce qui suit :
{
"error":{
"code":"5016",
"message":"The merchant account submitted with your request could not be found",
"details":[
"Account 89983659 does not exist"
],
"links":[
{
"rel":"errorinfo",
"href":"https://developer.paysafe.com/en/rest-api/direct-debit/test-and-go-live/direct-debit-errors/#ErrorCode5016"
}
]
}
}
{
"error":{
"code":"5270",
"message":"The credentials provided with the request do not have permission to access the data requested.",
"links":[
{
"rel":"errorinfo",
"href":"https://developer.paysafe.com/en/rest-api/direct-debit/test-and-go-live/direct-debit-errors/#ErrorCode5270"
}
]
}
}
L’objet error comporte les éléments suivants :
Élément | Type | 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 | Autres détails concernant l’erreur. | Facultatif | |
links (Tableau de paires rel:href) | 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 Prélèvement automatique, 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 prélèvement automatique
Code d’état HTTP | Code d’erreur | Description |
---|---|---|
400 | 2004 | La transaction de prélèvement automatique est introuvable. |
400 | 2011 | Vous avez soumis une référence de mandat qui n’existe pas. |
400 | 2012 | Vous avez soumis une référence de mandat qui n’est pas encore active. |
400 | 2013 | La référence du mandat n’a pas d’état valide. |
400 | 2014 | La référence du mandat est déjà utilisée pour les informations bancaires spécifiées. |
400 | 2017 | Le système bancaire de jeton de paiement ne correspond pas au système bancaire du compte du marchand. |
402 | 4002 | La transaction a été refusée par notre service de gestion des risques. |
400 | 2019 | Les informations bancaires et de compte spécifiées sont actuellement à l’état INVALID. |
Code de retour
Il arrive qu’une requête API de prélèvement automatique aboutisse, mais qu’elle échoue au niveau du réseau bancaire, par exemple en raison d’une insuffisance de fonds ou de la fermeture du compte bancaire. Dans ce cas, le système bancaire fournit un code de retour en guise d’explication. Le traitement des requêtes de prélèvement automatique pouvant prendre jusqu’à 7 jours, vous ne pouvez pas être informé de telles erreurs par le biais de la réponse de l’API.
Cependant, vous pouvez utiliser le Portail Paysafe pour exécuter des rapports permettant de visualiser les codes de retour en cas d’échec d’une requête de prélèvement automatique.
Code | Description | Système bancaire |
---|---|---|
900 | Refus de validation | TEF |
901 | Fonds insuffisants (débits seulement) | TEF |
902 | Impossible de retracer | TEF |
903 | Opposition au paiement/rappel | TEF |
904 | Postdaté/périmé | TEF |
905 | Compte fermé | TEF |
906 | Compte transféré | TEF |
907 | Pas de privilèges pour les chèques | TEF |
908 | Fonds non compensés | TEF |
909 | Inadéquation entre la devise et le compte | TEF |
910 | Payeur/bénéficiaire décédé | TEF |
911 | Compte gelé | TEF |
912 | Numéro de compte non valide/erroné | TEF |
914 | Nom du payeur/bénéficiaire erroné | TEF |
915 | Refusé par le payeur/bénéficiaire | TEF |
916 | Non conforme à l’accord – personnel | TEF |
917 | Accord révoqué – personnel | TEF |
918 | Pas de préavis – personnel | TEF |
919 | Non conforme à l’accord – commercial | TEF |
920 | Accord révoqué – commercial | TEF |
921 | Pas de préavis – commercial | TEF |
922 | Crédit pour retour à l’initiative du client uniquement | TEF |
990 | Institution en défaut | TEF |
998 | Accord de non-retour | TEF |
4 | TRANSACTION TYPE est non valide ou vide. La liste des types de transactions CPA figure à l’annexe 3. | TEF |
5 | AMOUNT vide ou n’est pas supérieur à zéro. | TEF |
6 | DUE DATE non valide ou vide. | TEF |
7 | INSTITUTION (acheminement et/ou transit) n’est pas dans le bon format, n’existe pas ou est vide. | TEF |
8 | Le format ACCOUNT NUMBER n’est pas valide pour l’INSTITUTION spécifiée. | TEF |
9 | ITEM TRACE NO. non valide. | TEF |
10 | STORED TRANSACTION TYPE non valide ou vide. | TEF |
11 | ORIGINATOR SHORT NAME vide. | TEF |
12 | PAYOR/PAYEE NAME vide. | TEF |
13 | ORIGINATOR LONG NAME vide. | TEF |
14 | Identifiant de l’adhérent expéditeur non valide ou vide. | TEF |
15 | CROSS REFERENCE vide. | TEF |
15 | INSTITUTION FOR RETURNS (acheminement et/ou transit) non valide ou vide. Doit préciser votre coopérative de crédit. | TEF |
19 | Numéro repère de l’article original non valide ou vide. | TEF |
21 | DATA ELEMENT ID non valide ou vide. | TEF |
E | Accepté mais des erreurs ont été relevées | TEF |
M | Refusé, échec du code d’authentification des messages (MAC) | TEF |
P | Acceptation partielle, au moins un ensemble de transactions a été refusé | TEF |
R | Refusé | TEF |
W | Refusé, l’assurance a échoué aux tests de validité | TEF |
X | Refusé, le contenu après déchiffrement n’a pas pu être analysé | TEF |
TR | Refusé par 824 | TEF |
YE | Code de transaction non autorisé pour le compte d’origine | BACS |
0 | Renvoi au payeur | BACS |
1 | Instruction annulée par le payeur | BACS |
2 | Payeur décédé | BACS |
3 | Compte transféré | BACS |
4 | Préavis contesté | BACS |
5 | Absence de compte | BACS |
6 | Absence d’instruction | BACS |
7 | Différence de montant | BACS |
8 | Montant non encore exigible | BACS |
9 | Présentation en retard | BACS |
A | L’utilisateur du service diffère | BACS |
B | Compte fermé | BACS |
E | Instruction modifiée | BACS |
AE | Code de tri d’origine et/ou numéro de compte non valide (provenant de la banque) | BACS |
BE | Code de tri d’origine et/ou numéro de compte non valide (provenant du client) | BACS |
CE | Code de tri de destination et code de tri d’origine et/ou numéro de compte non valide (provenant de la banque) | BACS |
DE | Code de tri de destination et code de tri d’origine et/ou numéro de compte non valide (provenant du client) | BACS |
EE | Code de tri de destination non valide | BACS |
FE | Type de compte et code de tri d’origine et/ou numéro de compte non valide (provenant de la banque) | BACS |
GE | Type de compte et code de tri d’origine et/ou numéro de compte non valide (provenant du client) | BACS |
HE | Code de tri et type de compte de destination et code de tri et/ou numéro de compte d’origine non valides (provenant de la banque) | BACS |
IE | Code de tri et type de compte de destination et code de tri et/ou numéro de compte d’origine non valides (provenant du client) | BACS |
JE | Code de tri de destination et type de compte non valides | BACS |
KE | Type de compte non valide | BACS |
LE | Numéro de compte de destination et nom de compte de destination et autres champs non valides | BACS |
ME | Numéro de compte de destination et nom de compte de destination non valides | BACS |
NE | Le dossier Contra a été modifié | BACS |
OE | Numéro de référence non valide | BACS |
PE | Le compte d’origine ne prend pas en charge la devise du fichier | BACS |
QE | Annulation automatisée en raison d’une erreur | BACS |
RE | Annulation d’un autre article (le même jour) | BACS |
SE | Rappel automatisé | BACS |
TE | Le compte d’origine n’est pas valide et a été remplacé par les données du compte principal par défaut, mais ce compte ne prend pas en charge la devise du fichier (provenant du client). | BACS |
UE | La référence de prélèvement automatique impayé était erronée (provenant de la banque) | BACS |
XE | Le numéro d’utilisateur du service du donneur d’ordre n’est pas valide (provenant de la banque) | BACS |
ZE | La référence du prélèvement impayé et d’autres champs étaient erronés (provenant de la banque) | BACS |
1I | Le montant et/ou la date du prélèvement automatique diffèrent du préavis | BACS |
2I | Le payeur n’a pas reçu de préavis et/ou le montant indiqué est contesté. | BACS |
3I | IDD annulé par la banque de paiement | BACS |
4I | Le payeur a annulé l’IDD avec l’utilisateur du service | BACS |
5I | Utilisateurs du service AUDDIS uniquement – aucune instruction n’a été donnée. Le payeur conteste avoir donné l’autorisation | BACS |
6I | Utilisateurs du service AUDDIS uniquement – la signature sur l’IDD est frauduleuse ou ne correspond pas à la (aux) signature(s) autorisée(s) pour le compte. | BACS |
7I | Réclamation soulevée à la demande des utilisateurs du service après que le prélèvement automatique a été effectué sur le compte du payeur | BACS |
8I | Nom de l’utilisateur du service contesté. Le payeur ne reconnaît pas l’utilisateur du service qui perçoit le prélèvement automatique. | BACS |
CC | Demandé par le donneur d’ordre | BACS |
OC | Données non valides | BACS |
2C | Bénéficiaire décédé | BACS |
3C | Compte transféré | BACS |
5C | Absence de compte | BACS |
BC | Compte fermé | BACS |
C | Compte transféré dans une autre succursale de la banque ou de la société de crédit immobilier | BACS |
D | Préavis contesté | BACS |
F | Type de compte non valide | BACS |
G | La banque n’accepte pas les prélèvements automatiques sur le compte | BACS |
H | Instruction expirée | BACS |
I | La référence au payeur n’est pas unique | BACS |
K | Instruction annulée par la banque de paiement | BACS |
L | Données du compte du payeur erronées | BACS |
M | Code de transaction/état de l’utilisateur incompatible | BACS |
N | Opération refusée à la succursale du payeur | BACS |
O | Référence non valide | BACS |
P | Nom du payeur absent | BACS |
Q | Nom de l’utilisateur du service vide | BACS |
R | Instruction rétablie (maximum 2 mois à compter de la date d’annulation de l’IDD) | BACS |
AC01 | Identifiant de compte erroné | SEPA |
UPAY | Paiement indu | SEPA |
AC06 | Compte bloqué | SEPA |
AC13 | Type de compte débiteur non valide | SEPA |
AG01 | Prélèvement automatique non autorisé | SEPA |
AG02 | Code d’opération bancaire non valide | SEPA |
AGNT | Agent erroné | SEPA |
AM04 | Insuffisance de fonds | SEPA |
AM05 | En double | SEPA |
BE04 | Adresse du créancier manquante | SEPA |
BE05 | Créancier non reconnu | SEPA |
CURR | Devise incorrecte | SEPA |
CUST | Rappel par le client | SEPA |
CUTA | Rappel en raison d’une demande d’enquête | SEPA |
DT01 | Date non valide | SEPA |
DUPL | Paiement en double | SEPA |
ED05 | Échec de règlement | SEPA |
FF01 | Format de fichier non valide | SEPA |
FF05 | Type de prélèvement automatique erroné | SEPA |
FRAD | Fraude | SEPA |
MD01 | Mandat non valide | SEPA |
MD02 | Données du mandat manquantes ou erronées | SEPA |
MD06 | Transaction autorisée contestée | SEPA |
MD07 | Débiteur décédé | SEPA |
MS02 | Refus du débiteur | SEPA |
MS03 | Raison non précisée | SEPA |
PY01 | Non acheminable | SEPA |
RC01 | Identifiant de la banque erroné | SEPA |
RR01 | Compte ou identification du débiteur manquant | SEPA |
RR02 | Nom ou adresse du débiteur manquant | SEPA |
RR03 | Nom ou adresse du créancier manquant | SEPA |
RR04 | Raison réglementaire | SEPA |
SL01 | Service spécifique offert par l’agent du débiteur | SEPA |
TECH | Paiement par erreur en raison d’un problème technique | SEPA |
TM01 | Heure limite non valide | SEPA |
AC04 | Compte fermé | SEPA |
RT introuvable | (CCA) ACH | |
CONFIG | Problème de configuration du client | (CCA) ACH |
LIMIT | Le montant maximum par chèque a été dépassé. | (CCA) ACH |
INVACCT | Type de compte non valide | (CCA) ACH |
INVDIR | Direction non valide | (CCA) ACH |
NOPOP | Le marchand n’est pas configuré ou n’est pas autorisé à effectuer des transactions POP – conversion de chèque électronique. | (CCA) ACH |
PAPER | Brouillon papier et impossibilité d’envoyer des documents. | (CCA) ACH |
PARSE | Problème d’analyse | (CCA) ACH |
THOMSON | Refusé en raison de la base de données Thomson. | (CCA) ACH |
UNKMER | Marchand inconnu | (CCA) ACH |
DEMO | Transaction ou marchand de démonstration | (CCA) ACH |
R90 | Chiffre MOD non valide | (CCA) ACH |
R91 | ABA non valide Pas neuf (9) caractères ou chiffres | (CCA) ACH |
R92 | ABA inactif | (CCA) ACH |
R93 | Code Tran non valide SEC combo | (CCA) ACH |
R94 | Montant non valide pour la pré-note Code Tran | (CCA) ACH |
R95 | Le montant est de zéro (0) | (CCA) ACH |
R96 | Code Tran non valide | (CCA) ACH |
R97 | Code SEC non valide | (CCA) ACH |
R98 | Erreur de déchiffrement du compte | (CCA) ACH |
R99 | Correspondance possible avec l’OFAC | (CCA) ACH |
R37 | Document source présenté pour paiement | (CCA) ACH |
R38 | Arrêt de paiement sur document source | (CCA) ACH |
R39 | Document source incorrect | (CCA) ACH |
R53 | Effet et saisie ACH présentés pour paiement | (CCA) ACH |
R75 | Le retour initial n’est pas un double | (CCA) ACH |
R76 | Aucune erreur relevée | (CCA) ACH |
R83 | IFD réceptrice étrangère incapable de régler le litige | (CCA) ACH |
R84 | Saisie non traitée par OGO | (CCA) ACH |
R01 | Insuffisance de fonds | (CCA) ACH |
R02 | Compte fermé | (CCA) ACH |
R03 | Pas de compte/impossible de localiser | (CCA) ACH |
R04 | Numéro de compte non valide | (CCA) ACH |
R05 | Réserves | (CCA) ACH |
R06 | Retour demandé par l’IFDO | (CCA) ACH |
R07 | Annulation de l’autorisation Note 2 | (CCA) ACH |
R08 | Arrêt de paiement | (CCA) ACH |
R09 | Fonds non perçus | (CCA) ACH |
R10 | Non autorisé Note 2 | (CCA) ACH |
R11 | Vérifier le retour de la saisie de la troncature | (CCA) ACH |
R12 | Succursale vendue à une autre IFD | (CCA) ACH |
R13 | IFDR non qualifiée pour participer/ou acheminement non valide | (CCA) ACH |
R14 | Bénéficiaire décédé | (CCA) ACH |
R15 | Bénéficiaire décédé | (CCA) ACH |
R16 | Compte gelé | (CCA) ACH |
R17 | Critères d’édition d’un enregistrement de fichier | (CCA) ACH |
R18 | Date d’entrée en vigueur incorrecte | (CCA) ACH |
R19 | Erreur dans le champ du montant | (CCA) ACH |
R20 | Absence de compte de transaction | (CCA) ACH |
R21 | Identité de l’entreprise non valide | (CCA) ACH |
R22 | Numéro d’identification de la personne non valide | (CCA) ACH |
R23 | Écriture de crédit refusée par le destinataire | (CCA) ACH |
R24 | Saisie en double | (CCA) ACH |
R25 | Erreur d’addenda | (CCA) ACH |
R26 | Erreur dans un champ obligatoire | (CCA) ACH |
R27 | Erreur de numéro de trace | (CCA) ACH |
R28 | Erreur de numéro d’acheminement/chiffre de vérification | (CCA) ACH |
R29 | Conseiller client entr. non autor. | (CCA) ACH |
R30 | Problèmes de troncature de RDFI non part. | (CCA) ACH |
R31 | Saisie de retour autorisée | (CCA) ACH |
R32 | Non règlement RDFI | (CCA) ACH |
R33 | Retour de saisie XCK | (CCA) ACH |
R34 | Participation limitée DFI | (CCA) ACH |
R35 | Retour d’une saisie de débit erronée | (CCA) ACH |
R36 | Retour d’une saisie de crédit erronée | (CCA) ACH |
R40 | Retour d’une saisie ENR par le gouv. féd. | (CCA) ACH |
R41 | Code de transaction non valide | (CCA) ACH |
R42 | Erreur de numéro d’acheminement/chiffre de vérification | (CCA) ACH |
R43 | No. compte DFI non valide | (CCA) ACH |
R44 | Numéro ED de la personne non valide | (CCA) ACH |
R45 | Nom de la personne/nom de l’entreprise non valide | (CCA) ACH |
R46 | Indicateur du bénéficiaire non valide | (CCA) ACH |
R47 | Inscription en double | (CCA) ACH |
R50 | Loi de l’État affectant l’acceptation RCK | (CCA) ACH |
R51 | L’article est non admissible (RCK) | (CCA) ACH |
R52 | Arrêt de paiement sur article (RCK) | (CCA) ACH |
R61 | Non honoré | (CCA) ACH |
R62 | Non honoré | (CCA) ACH |
R63 | Non honoré | (CCA) ACH |
R64 | Non honoré | (CCA) ACH |
R65 | Non honoré | (CCA) ACH |
R66 | Non honoré | (CCA) ACH |
R67 | Non honoré | (CCA) ACH |
R68 | Non honoré | (CCA) ACH |
R69 | Non honoré | (CCA) ACH |
R70 | Non honoré | (CCA) ACH |
R71 | ContestedNote 4 | (CCA) ACH |
R72 | ContestedNote 4 | (CCA) ACH |
R73 | ContestedNote 4 | (CCA) ACH |
R74 | ContestedNote 4 | (CCA) ACH |
R80 | Erreur de codage des paiements transfrontaliers | (CCA) ACH |
R81 | Non participant au prog. transfrontalier | (CCA) ACH |
R82 | Identifiant de RDFI étranger non valide | (CCA) ACH |