• France
état des services
Back Office Marchand
assistance
FAQContacter le support
Tutoriels vidéo
Rechercher
Catégories
Tags
Français
Français
Anglais
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
Intégration mobile
Échange de fichiers
Exemples de code
Logos
Push mail
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

Traitement des erreurs

Il y a deux catégories d’erreur :

  • Les erreurs de format et/ou valorisation de champ.
  • Les erreurs liées à l’exécution des paiements.

Le traitement effectué par la plateforme s’effectue en deux phases :

  • La première phase vérifie l’intégrité du fichier et détecte les erreurs de format et/ou de valorisation. En cas d’erreur, le fichier est rejeté dans son intégralité.

    Cette première phase ne réalise des contrôles que sur la globalité du fichier. Les cas d’erreur sur les enregistrements détail sont traités dans la deuxième phase.

  • La deuxième phase procède à l’exécution des paiements, ligne par ligne. En cas d’erreur sur un des paramètres (exemple : identifiant non trouvé, devise incorrecte, etc.), le code de traitement sera valorisé à 30 dans l’enregistrement détail, et un champ complémentaire désignera la position de la donnée concernée. En cas de refus d’un paiement, l’origine du refus sera renseignée au niveau de l’enregistrement de détail.

Dans le premier cas d’erreur, le fichier de résultat ne comprendra qu’un unique enregistrement d’entête matérialisant l’incident et un enregistrement de fin. Le marchand devra resoumettre le fichier après correction, en modifiant le nom du fichier échangé.

Dans le deuxième cas, le fichier de résultat contiendra le même nombre d’enregistrements de détail que le fichier de demande. Seuls les paiements pour lesquels il y aura eu une erreur sur un des paramètres seront à resoumettre par le marchand.

Si un incident de fonctionnement survient et que la plateforme n’a pu traiter en temps et en heure le fichier, les traitements manquants seront effectués après rétablissement du service. Il ne faut donc pas représenter les paiements non traités dans un nouveau fichier.

Si un fichier est soumis avec un nom qui ne rentre pas dans la description attendue (format inattendu, numéro de boutique inconnu), il sera suffixé « _ERROR ».

Si un fichier a déjà été traité, il sera suffixé « _DUPLICATE ».

Le tableau ci-dessous récapitule les codes d'erreurs applicatives qui peuvent être retournés.

Code d'erreur Description
0 Transaction réalisée avec succès.
1 Transaction non autorisée.
2 Transaction non trouvée.
3 Statut de la transaction incorrect.
4 Transaction existe déjà.
6 Mauvaise date.
10 Montant invalide.
11 Devise invalide.
12 Type de carte inconnu.
13 Date d'expiration de la carte invalide.
15 Numéro de contrat inconnu.
16 Le numéro de carte est invalide.
26 Aucun changement (entre la transaction d’origine et la requête « Modify »).
27 Montant non autorisé.
99 Erreur inconnue.
© 2025 Tous droits réservés à SystempayMentions légales
25.25.0-1.11