Search Overlay

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émentType Requis?
codestringLe code d’erreur Également affiché dans l’en-tête de réponse X-Application-Status-Code.Oui
messagestringLe message d’erreur qui décrit l’erreur.Oui
detailstableau de chaînesAutres détails concernant l’erreur.Facultatif
links
(Tableau de paires rel:href)
relstringLe type de lien : "errorinfo".Oui
hrefstringL’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 codeDescription
1xx: InformationalCommunique des informations au niveau du protocole de transfert.
2xx: SuccessIndique que la demande du client a été acceptée.
3xx: RedirectionIndique que le client doit effectuer une action supplémentaire pour terminer la demande.
4xx: Client ErrorIndique que le client a commis une erreur dans la demande.
5xx: Server ErrorIndique qu’une erreur s’est produite du côté du serveur

Codes d’état de réponse HTTP courants

CodeDescription
200 OKTout a fonctionné comme prévu.
201 CreatedLa requête a réussi. Paysafe a créé une nouvelle ressource, et le corps de la réponse contient la représentation.
202 AcceptedCeci 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 ContentGé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 ModifiedLa version de la représentation mise en cache par le client est toujours à jour.
400 Bad RequestIndique 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 UnauthorizedIndique 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 RequiredLes paramètres étaient valides mais la requête a échoué.
404 Not FoundLa ressource demandée n’existe pas.
405 Method Not AllowedLe 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 RequestsL’application envoie trop de requêtes simultanées.
500 Internal Server ErrorUne erreur s’est produite avec un serveur interne.
502 External Server ErrorNous 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 HTTPCode d’erreurDescription
5001000Une erreur interne s’est produite.
5021001Une erreur s’est produite avec la passerelle de sous-traitance.
5001002Une erreur interne s’est produite.
5001003Une erreur interne s’est produite.
5001007Une erreur interne s’est produite.
5001008Une erreur interne s’est produite.
4291200L’appel API a été refusé car il a dépassé la limite du nombre d’appels autorisé.
4015000L’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.
4005001Le code de devise soumis n’est pas valide ou votre compte ne prend pas en charge cette devise.
4005003Vous avez soumis un montant non valide avec votre requête.
4005004Vous avez soumis un type de compte non valide avec votre requête.
4005005Vous avez soumis un type d’opération non valide avec votre requête.
4005010Le code de pays soumis n’est pas valide.
4005016Le compte marchand que vous avez fourni est introuvable.
4005017Le compte marchand que vous avez fourni est désactivé.
4025021Votre requête de transaction a été refusée.
4005023La requête ne peut être interprétée.
4095031La transaction que vous avez soumise a déjà été traitée.
4015040Votre compte marchand n’est pas configuré pour la transaction que vous avez tenté d’effectuer.
4005042Le numéro de référence du marchand est manquant, non valide ou dépasse la longueur maximale autorisée.
4005068Soit 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.
4045269Le ou les identifiants spécifiés dans l’URL ne correspondent pas aux valeurs du système.
4035270Les authentifiants fournis avec la requête ne permettent pas d’accéder aux données demandées.
4065271Vous avez demandé une réponse dans l’en-tête ‘Accept’ qui est dans un format non pris en charge.
4065272Le 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.
4045273Votre client a accédé à notre application, mais nous n’avons pas pu répondre à votre requête en raison d’une URL non valide.
4015275Les authentifiants fournis avec la requête ont expiré.
4015276Les authentifiants fournis avec la requête ont été désactivés.
4015277Les authentifiants fournis avec la requête ont été verrouillés en raison de plusieurs échecs d’authentification.
4015278Les authentifiants fournis avec la requête n’ont pas été acceptés pour une raison inconnue.
4015279Les authentifiants ne sont pas valides.
4015280Les authentifiants requis n’ont pas été fournis.
4055281La requête utilise une action (p. ex. GET, POST ou PUT) que la ressource ne prend pas en charge.
4005501Le profil ne comporte pas de carte de crédit active.
4005500Soit 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 HTTPCode d’erreurDescription
4002004La transaction de prélèvement automatique est introuvable.
4002011Vous avez soumis une référence de mandat qui n’existe pas.
4002012Vous avez soumis une référence de mandat qui n’est pas encore active.
4002013La référence du mandat n’a pas d’état valide.
4002014La référence du mandat est déjà utilisée pour les informations bancaires spécifiées.
4002017Le système bancaire de jeton de paiement ne correspond pas au système bancaire du compte du marchand.
4024002La transaction a été refusée par notre service de gestion des risques.
4002019Les 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.

CodeDescriptionSystème bancaire
900Refus de validationTEF
901Fonds insuffisants (débits seulement)TEF
902Impossible de retracerTEF
903Opposition au paiement/rappelTEF
904Postdaté/périméTEF
905Compte ferméTEF
906Compte transféréTEF
907Pas de privilèges pour les chèquesTEF
908Fonds non compensésTEF
909Inadéquation entre la devise et le compteTEF
910Payeur/bénéficiaire décédéTEF
911Compte geléTEF
912Numéro de compte non valide/erronéTEF
914Nom du payeur/bénéficiaire erronéTEF
915Refusé par le payeur/bénéficiaireTEF
916Non conforme à l’accord – personnelTEF
917Accord révoqué – personnelTEF
918Pas de préavis – personnelTEF
919Non conforme à l’accord – commercialTEF
920Accord révoqué – commercialTEF
921Pas de préavis – commercialTEF
922Crédit pour retour à l’initiative du client uniquementTEF
990Institution en défautTEF
998Accord de non-retourTEF
4TRANSACTION TYPE est non valide ou vide. La liste des types de transactions CPA figure à l’annexe 3.TEF
5AMOUNT vide ou n’est pas supérieur à zéro.TEF
6DUE DATE non valide ou vide.TEF
7INSTITUTION (acheminement et/ou transit) n’est pas dans le bon format, n’existe pas ou est vide.TEF
8Le format ACCOUNT NUMBER n’est pas valide pour l’INSTITUTION spécifiée.TEF
9ITEM TRACE NO. non valide.TEF
10STORED TRANSACTION TYPE non valide ou vide.TEF
11ORIGINATOR SHORT NAME vide.TEF
12PAYOR/PAYEE NAME vide.TEF
13ORIGINATOR LONG NAME vide.TEF
14Identifiant de l’adhérent expéditeur non valide ou vide.TEF
15CROSS REFERENCE vide.TEF
15INSTITUTION FOR RETURNS (acheminement et/ou transit) non valide ou vide. Doit préciser votre coopérative de crédit.TEF
19Numéro repère de l’article original non valide ou vide.TEF
21DATA ELEMENT ID non valide ou vide.TEF
EAccepté mais des erreurs ont été relevéesTEF
MRefusé, échec du code d’authentification des messages (MAC)TEF
PAcceptation partielle, au moins un ensemble de transactions a été refuséTEF
RRefuséTEF
WRefusé, l’assurance a échoué aux tests de validitéTEF
XRefusé, le contenu après déchiffrement n’a pas pu être analyséTEF
TRRefusé par 824TEF
YECode de transaction non autorisé pour le compte d’origineBACS
0Renvoi au payeurBACS
1Instruction annulée par le payeurBACS
2Payeur décédéBACS
3Compte transféréBACS
4Préavis contestéBACS
5Absence de compteBACS
6Absence d’instructionBACS
7Différence de montantBACS
8Montant non encore exigibleBACS
9Présentation en retardBACS
AL’utilisateur du service diffèreBACS
BCompte ferméBACS
EInstruction modifiéeBACS
AECode de tri d’origine et/ou numéro de compte non valide (provenant de la banque)BACS
BECode de tri d’origine et/ou numéro de compte non valide (provenant du client)BACS
CECode de tri de destination et code de tri d’origine et/ou numéro de compte non valide (provenant de la banque)BACS
DECode de tri de destination et code de tri d’origine et/ou numéro de compte non valide (provenant du client)BACS
EECode de tri de destination non valideBACS
FEType de compte et code de tri d’origine et/ou numéro de compte non valide (provenant de la banque)BACS
GEType de compte et code de tri d’origine et/ou numéro de compte non valide (provenant du client)BACS
HECode 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
IECode 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
JECode de tri de destination et type de compte non validesBACS
KEType de compte non valideBACS
LENuméro de compte de destination et nom de compte de destination et autres champs non validesBACS
MENuméro de compte de destination et nom de compte de destination non validesBACS
NELe dossier Contra a été modifiéBACS
OENuméro de référence non valideBACS
PELe compte d’origine ne prend pas en charge la devise du fichierBACS
QEAnnulation automatisée en raison d’une erreurBACS
REAnnulation d’un autre article (le même jour)BACS
SERappel automatiséBACS
TELe 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
UELa référence de prélèvement automatique impayé était erronée (provenant de la banque)BACS
XELe numéro d’utilisateur du service du donneur d’ordre n’est pas valide (provenant de la banque)BACS
ZELa référence du prélèvement impayé et d’autres champs étaient erronés (provenant de la banque)BACS
1ILe montant et/ou la date du prélèvement automatique diffèrent du préavisBACS
2ILe payeur n’a pas reçu de préavis et/ou le montant indiqué est contesté.BACS
3IIDD annulé par la banque de paiementBACS
4ILe payeur a annulé l’IDD avec l’utilisateur du serviceBACS
5IUtilisateurs du service AUDDIS uniquement – aucune instruction n’a été donnée. Le payeur conteste avoir donné l’autorisationBACS
6IUtilisateurs 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
7IRéclamation soulevée à la demande des utilisateurs du service après que le prélèvement automatique a été effectué sur le compte du payeurBACS
8INom 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
CCDemandé par le donneur d’ordreBACS
OCDonnées non validesBACS
2CBénéficiaire décédéBACS
3CCompte transféréBACS
5CAbsence de compteBACS
BCCompte ferméBACS
CCompte transféré dans une autre succursale de la banque ou de la société de crédit immobilierBACS
DPréavis contestéBACS
FType de compte non valideBACS
GLa banque n’accepte pas les prélèvements automatiques sur le compteBACS
HInstruction expiréeBACS
ILa référence au payeur n’est pas uniqueBACS
KInstruction annulée par la banque de paiementBACS
LDonnées du compte du payeur erronéesBACS
MCode de transaction/état de l’utilisateur incompatibleBACS
NOpération refusée à la succursale du payeurBACS
ORéférence non valideBACS
PNom du payeur absentBACS
QNom de l’utilisateur du service videBACS
RInstruction rétablie (maximum 2 mois à compter de la date d’annulation de l’IDD)BACS
AC01Identifiant de compte erronéSEPA
UPAYPaiement induSEPA
AC06Compte bloquéSEPA
AC13Type de compte débiteur non valideSEPA
AG01Prélèvement automatique non autoriséSEPA
AG02Code d’opération bancaire non valideSEPA
AGNTAgent erronéSEPA
AM04Insuffisance de fondsSEPA
AM05En doubleSEPA
BE04Adresse du créancier manquanteSEPA
BE05Créancier non reconnuSEPA
CURRDevise incorrecteSEPA
CUSTRappel par le clientSEPA
CUTARappel en raison d’une demande d’enquêteSEPA
DT01Date non valideSEPA
DUPLPaiement en doubleSEPA
ED05Échec de règlementSEPA
FF01Format de fichier non valideSEPA
FF05Type de prélèvement automatique erronéSEPA
FRADFraudeSEPA
MD01Mandat non valideSEPA
MD02Données du mandat manquantes ou erronéesSEPA
MD06Transaction autorisée contestéeSEPA
MD07Débiteur décédéSEPA
MS02Refus du débiteurSEPA
MS03Raison non préciséeSEPA
PY01Non acheminableSEPA
RC01Identifiant de la banque erronéSEPA
RR01Compte ou identification du débiteur manquantSEPA
RR02Nom ou adresse du débiteur manquantSEPA
RR03Nom ou adresse du créancier manquantSEPA
RR04Raison réglementaireSEPA
SL01Service spécifique offert par l’agent du débiteurSEPA
TECHPaiement par erreur en raison d’un problème techniqueSEPA
TM01Heure limite non valideSEPA
AC04Compte ferméSEPA
RT introuvable (CCA) ACH
CONFIGProblème de configuration du client(CCA) ACH
LIMITLe montant maximum par chèque a été dépassé.(CCA) ACH
INVACCTType de compte non valide(CCA) ACH
INVDIRDirection non valide(CCA) ACH
NOPOPLe marchand n’est pas configuré ou n’est pas autorisé à effectuer des transactions POP – conversion de chèque électronique.(CCA) ACH
PAPERBrouillon papier et impossibilité d’envoyer des documents.(CCA) ACH
PARSEProblème d’analyse(CCA) ACH
THOMSONRefusé en raison de la base de données Thomson.(CCA) ACH
UNKMERMarchand inconnu(CCA) ACH
DEMOTransaction ou marchand de démonstration(CCA) ACH
R90Chiffre MOD non valide(CCA) ACH
R91ABA non valide Pas neuf (9) caractères ou chiffres(CCA) ACH
R92ABA inactif(CCA) ACH
R93Code Tran non valide SEC combo(CCA) ACH
R94Montant non valide pour la pré-note Code Tran(CCA) ACH
R95Le montant est de zéro (0)(CCA) ACH
R96Code Tran non valide(CCA) ACH
R97Code SEC non valide(CCA) ACH
R98Erreur de déchiffrement du compte(CCA) ACH
R99Correspondance possible avec l’OFAC(CCA) ACH
R37Document source présenté pour paiement(CCA) ACH
R38Arrêt de paiement sur document source(CCA) ACH
R39Document source incorrect(CCA) ACH
R53Effet et saisie ACH présentés pour paiement(CCA) ACH
R75Le retour initial n’est pas un double(CCA) ACH
R76Aucune erreur relevée(CCA) ACH
R83IFD réceptrice étrangère incapable de régler le litige(CCA) ACH
R84Saisie non traitée par OGO(CCA) ACH
R01Insuffisance de fonds(CCA) ACH
R02Compte fermé(CCA) ACH
R03Pas de compte/impossible de localiser(CCA) ACH
R04Numéro de compte non valide(CCA) ACH
R05Réserves(CCA) ACH
R06Retour demandé par l’IFDO(CCA) ACH
R07Annulation de l’autorisation Note 2(CCA) ACH
R08Arrêt de paiement(CCA) ACH
R09Fonds non perçus(CCA) ACH
R10Non autorisé Note 2(CCA) ACH
R11Vérifier le retour de la saisie de la troncature(CCA) ACH
R12Succursale vendue à une autre IFD(CCA) ACH
R13IFDR non qualifiée pour participer/ou acheminement non valide(CCA) ACH
R14Bénéficiaire décédé(CCA) ACH
R15Bénéficiaire décédé(CCA) ACH
R16Compte gelé(CCA) ACH
R17Critères d’édition d’un enregistrement de fichier(CCA) ACH
R18Date d’entrée en vigueur incorrecte(CCA) ACH
R19Erreur dans le champ du montant(CCA) ACH
R20Absence de compte de transaction(CCA) ACH
R21Identité de l’entreprise non valide(CCA) ACH
R22Numéro d’identification de la personne non valide(CCA) ACH
R23Écriture de crédit refusée par le destinataire(CCA) ACH
R24Saisie en double(CCA) ACH
R25Erreur d’addenda(CCA) ACH
R26Erreur dans un champ obligatoire(CCA) ACH
R27Erreur de numéro de trace(CCA) ACH
R28Erreur de numéro d’acheminement/chiffre de vérification(CCA) ACH
R29Conseiller client entr. non autor.(CCA) ACH
R30Problèmes de troncature de RDFI non part.(CCA) ACH
R31Saisie de retour autorisée(CCA) ACH
R32Non règlement RDFI(CCA) ACH
R33Retour de saisie XCK(CCA) ACH
R34Participation limitée DFI(CCA) ACH
R35Retour d’une saisie de débit erronée(CCA) ACH
R36Retour d’une saisie de crédit erronée(CCA) ACH
R40Retour d’une saisie ENR par le gouv. féd.(CCA) ACH
R41Code de transaction non valide(CCA) ACH
R42Erreur de numéro d’acheminement/chiffre de vérification(CCA) ACH
R43No. compte DFI non valide(CCA) ACH
R44Numéro ED de la personne non valide(CCA) ACH
R45Nom de la personne/nom de l’entreprise non valide(CCA) ACH
R46Indicateur du bénéficiaire non valide(CCA) ACH
R47Inscription en double(CCA) ACH
R50Loi de l’État affectant l’acceptation RCK(CCA) ACH
R51L’article est non admissible (RCK)(CCA) ACH
R52Arrêt de paiement sur article (RCK)(CCA) ACH
R61Non honoré(CCA) ACH
R62Non honoré(CCA) ACH
R63Non honoré(CCA) ACH
R64Non honoré(CCA) ACH
R65Non honoré(CCA) ACH
R66Non honoré(CCA) ACH
R67Non honoré(CCA) ACH
R68Non honoré(CCA) ACH
R69Non honoré(CCA) ACH
R70Non honoré(CCA) ACH
R71ContestedNote 4(CCA) ACH
R72ContestedNote 4(CCA) ACH
R73ContestedNote 4(CCA) ACH
R74ContestedNote 4(CCA) ACH
R80Erreur de codage des paiements transfrontaliers(CCA) ACH
R81Non participant au prog. transfrontalier(CCA) ACH
R82Identifiant de RDFI étranger non valide(CCA) ACH