• France
état des services
Back Office Marchand
assistance
FAQContacter le support
Video tutorials
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

Format

L'enregistrement « TITRE »

Pos. Description Valeurs
01 Code d'enregistrement TITRE
02 Libellé de la boutique tel que défini dans le Back Office Marchand. Ex : DEMO Store
03 Date et heure UTC de l'envoi (AA/MM/JJ_HH:MM:SS) 20/01/13_01:55:00
04 Version TABLE_V_CUSTOM

Les enregistrements « ENTETE » et « DETAILS »

Par défaut, le Journal des Transactions contient les données listées ci-dessous.

Pos. Description
01 ENTETE

Type : VARCHAR | Longueur : 11

Description : Code d'enregistrement.

Valeur : Toujours valorisé à TRANSACTION

02 TRANSACTION_ID

Type : VARCHAR | Longueur : 6

Description : Identifiant de la transaction.

Équivalent API Formulaire : vads_trans_id

Équivalent API REST : cardDetails.legacyTransId

Ex : xrT15p

03 MERCHANT_ID

Type : VARCHAR | Longueur : 255

Description : Identifiant légal de la société.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :

0+Identifiant légal

(Identifiant légal = SIRET (Système d'Identification du Répertoire des Etablissements))

Ex : 045251785700028

04 PAYMENT_MEANS

Type : VARCHAR | Longueur : 4

Description : Moyen de paiement.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeur : Toujours valorisé à CARD.

05 CONTRACT

Type : VARCHAR | Longueur : 255

Description : Numéro de contrat du marchand.

Équivalent API Formulaire : vads_contract_used

Équivalent API REST : transactionDetails.mid

Ex : 0535875

06 TRANSACTION_TYPE

Type : VARCHAR | Longueur : 255

Description : Type de transaction.

Équivalent API Formulaire : vads_operation_type

Équivalent API REST : operationType

Valeurs :
  • CREDIT : pour une transaction de remboursement
  • DEBIT : pour une transaction de débit
  • VERIFICATION : pour une transaction de vérification du moyen de paiement

Ex : DEBIT

07 ORIGIN_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant de la transaction au moment du paiement exprimé dans la plus petite unité de la devise.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

08 AMOUNT

Type : NUMERIC | Longueur : 13

Description : Solde de la transaction exprimé dans la plus petite unité de la devise.

Équivalent API Formulaire : vads_amount

Équivalent API REST : amount

Ex : 4525 pour 45,25 EUR

09 CURRENCY_CODE

Type : NUMERIC | Longueur : 3

Description : Code numérique de la devise du paiement (norme ISO 4217).

Équivalent API Formulaire : vads_currency

Équivalent API REST : currency

Valeurs : Liste des devises supportées

Ex : 978 pour l'euro (EUR)

10 PAYMENT_DATE

Type : DATE | Longueur : 8

Description : Date du paiement dans le fuseau UTC.

Équivalent API Formulaire : vads_effective_creation_date

Équivalent API REST : creationDate

Ex : 20200110

11 PAYMENT_TIME

Type : TIME | Longueur : 6

Description : Heure de paiement dans le fuseau UTC.

Équivalent API Formulaire : vads_effective_creation_date

Équivalent API REST : creationDate

Ex : 142512

12 CARD_VALIDITY

Type : NUMERIC | Longueur : 6

Description : Période de validité du moyen de paiement.

Équivalent API Formulaire : vads_expiry_year + vads_expiry_month

Équivalent API REST : transactionDetails.cardDetails.expiryYear + transactionDetails.cardDetails.expiryMonth

Ex : 202306

13 CARD_TYPE

Type : VARCHAR | Longueur : 255

Description : Type de carte.

Dans le cas d'un paiement par wallet, le type de carte est concaténé avec le type de wallet. Les données sont séparées par un espace.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex :
  • CB
  • VISA
  • MASTERCARD
  • VISA APPLE_PAY
  • MASTERCARD GOOGLEPAY
14 CARD_NUMBER

Description : Numéro du moyen de paiement sous la forme 123456XXXXXX1234.

Équivalent API Formulaire : vads_card_number

Équivalent API REST : transactionDetails.cardDetails.pan

Ex : 123456XXXXXX1234

15 RESPONSE_CODE

Type : NUMERIC | Longueur : 2

Description : Code retour de l'opération demandée.

Pour plus de détails, consultez le paramètre BANK_RESPONSE_CODE.

Valeurs :
  • 00 : Opération acceptée.
  • 05 : Opération refusée.
  • 17: Paiement annulé (uniquement pour un paiement sans autorisation ).
  • 34 : Opération refusée pour suspicion de fraude.
  • 75 : Opération refusée suite à un nombre de tentatives de saisie du numéro de carte dépassé.
  • 96 : Opération refusée suite à une erreur technique.

Ex : 00

16 COMPLEMENTARY_CODE

Type : NUMERIC | Longueur : 2

Description : Résultat de la gestion des risques (spécifique aux boutiques ayant souscrit au module). Champ vide si aucun contrôle n'a été effectué.

Équivalent API Formulaire : vads_extra_result

Équivalent API REST : N/A

Valeurs :
  • 00 : Contrôles effectués avec succès.
  • 02 : La carte a dépassé l'encours autorisé.
  • 03 : La carte appartient à la liste grise du marchand.
  • 04 : Le pays d'émission de la carte appartient à la liste grise ou bien n'appartient pas à la liste blanche du marchand.
  • 05 : L'adresse IP utilisée appartient à la liste grise du marchand.
  • 06 : La carte appartient à la liste grise BIN du marchand.
  • 07 : Contrôle e-carte bleue.
  • 08 : Transaction non garantie 3DS.
  • 14 : Contrôle carte à autorisation systématique.
  • 20 : Contrôle cohérence pays entre le pays émission de la carte, l’adresse IP et le pays de l’adresse du client.
  • 99 : Problème technique rencontré par le serveur lors du traitement d’un des contrôles locaux.

Ex : 00

17 CERTIFICATE

Type : VARCHAR | Longueur : 255

Description : Certificat de la transaction.

Équivalent API Formulaire : vads_payment_certificate

Équivalent API REST : N/A

Ex : 6ed7b71c023a20adbadf9a2e2c58cd4321f63123

18 AUTORISATION_ID

Type : VARCHAR | Longueur : 20

Description : Numéro d'autorisation de la transaction.

Équivalent API Formulaire : vads_auth_number

Équivalent API REST : transactionDetails.cardDetails.authorizationResponse.authorizationNumber

Ex : 3fc116

19 CAPTURE_DATE

Type : DATE | Longueur : 8

Description : Date d'envoi en banque demandée.

Équivalent API Formulaire : vads_presentation_date

Équivalent API REST : transactionDetails.cardDetails.expectedCaptureDate

Ex : 20200107

20 TRANSACTION_STATUS

Type : VARCHAR | Longueur : 255

Description : Statut de la transaction.

Équivalent API Formulaire : vads_trans_status

Équivalent API REST : detailedStatus

Valeurs :

  • ACCEPTED : Transaction de vérification acceptée.
  • AUTHORISED : Transaction en attente de remise
  • AUTHORISED_TO_VALIDATE : Transaction à valider
  • CANCELLED : Transaction annulée
  • CAPTURED : Transaction remisée
  • CAPTURED_FAILED : La remise de la transaction a échoué
  • EXPIRED : Transaction expirée
  • REFUSED : Transaction refusée
  • UNDER_VERIFICATION : Vérification en cours
  • WAITING_AUTHORISATION : Transaction en attente de demande d’autorisation ou de pré-notification
  • WAITING_AUTHORISATION_TO_VALIDATE : Transaction à valider et autoriser
  • WAITING_FOR_PAYMENT : En attente de paiement

Remarque :

Si vous utilisez toujours la colonne "TRANSACTION_STATUS (Obsolète)", les valeurs reçues sont :
  • REFUSED : Transaction refusée
  • TO_VALIDATE : Transaction à valider
  • TO_CAPTURE : Transaction en attente de remise
  • TO_CREDIT : Transaction de crédit (remboursement) en attente de remise
  • CANCELLED : Transaction annulée
  • CAPTURED : Transaction remisée
  • EXPIRED : Transaction expirée
  • TO_VALIDATE_AND_AUTHORIZE : Transaction à valider et autoriser
  • TO_AUTHORIZE : Transaction en attente de demande d’autorisation
  • TO_PRENOTIFY : Transaction en attente de pré-notification
  • ACCEPTED : Transaction de vérification acceptée
  • REFUSED_CAPTURED : La remise de la transaction a échoué
21 RETURN_CONTEXT

Type : VARCHAR | Longueur : 500

Description : Contexte de la commande d’un acheteur.

Concaténation des "informations complémentaires", séparées par le caractère "|".

Les informations complémentaires peuvent être transmises par le site marchand :

  • via les champs vads_order_info, vads_order_info2, vads_order_info3 du formulaire de paiement,
  • via les attributs orderInfo, orderInfo2, orderInfo3 de l'objet metadata de l'API REST.

Au-delà de 500 caractères, la chaîne est tronquée.

Champ vide si aucune information complémentaire n'est transmise.

Équivalent API Formulaire : vads_order_info | vads_order_info2 | vads_order_info3

|

Équivalent API REST : orderInfo | orderInfo2 | orderInfo3

Ex :
  • info1|info2|info3 si les 3 informations complémentaires sont transmises,
  • info1||info3: si seules les informations complémentaires 1 et 3 sont transmises.
22 AUTORESPONSE_STATUS

Type : VARCHAR | Longueur : 255

Description : État de l'envoi de la notification de fin de paiement (IPN).

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • FAILED : Echec de lors de la notification vers le serveur du marchand.
  • SENT : Notification envoyée au serveur du marchand.
  • UNDEFINED : Un événement a déclenché la règle de notification de fin de paiement mais l'URL n'est pas configurée.
Ex : SENT
23 ORDER_ID

Type : VARCHAR | Longueur : 255

 : Transaction deDescription : Numéro de commande générée par le site marchand.

Équivalent API Formulaire : vads_order_id

Équivalent API REST : orderDetails.orderId

Ex : CX-1254

24 CUSTOMER_ID

Type : VARCHAR | Longueur : 255

Description : Référence client générée par le site marchand.

Équivalent API Formulaire : vads_cust_id

Équivalent API REST : customer.reference

Ex : C2383333540

25 CUSTOMER_IP_ADDRESS

Type : VARCHAR | Longueur : 255

Description : Adresse IP de l'acheteur.

Équivalent API Formulaire : N/A

Équivalent API REST : customer.extraDetails.ipAddress

Ex : 185.244.73.2

26 ACCOUNT_SERIAL

Description : Alias suivi du n° éventuel d'abonnement, séparés par un tiret "-".

Équivalent API Formulaire : vads_identifier "-" vads_subscription

Équivalent API REST : paymentMethodToken "-" subscriptionId

Ex : 5fa8d3dede8f4c219c4652dfabe2bf55-20191106ANav0o

27 TRANSACTION_CONDITION

Type : VARCHAR | Longueur : 255

Description : Résultat de l'authentification 3D Secure.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • 3D_SUCCESS : Marchand et porteur inscrits à 3D Secure et carte authentifiée avec succès.
  • 3D_FAILURE : Marchand et acheteur inscrits à 3D Secure mais échec de l'authentification.
  • 3D_ERROR : Marchand inscrit à 3D Secure mais problème technique.
  • 3D_NOTENROLLED : Marchand inscrit à 3D Secure mais porteur non enrôlée.
  • 3D_ATTEMPT : Marchand et porteur inscrits à 3D Secure mais le porteur n'a pas eu à s'authentifier.
  • SSL: Porteur non authentifié :
    • soit type de carte non supporté par 3D Secure,
    • soit marchand ou porteur non inscrit à 3D Secure

Ex : 3D_SUCCESS

28 CAVV_UCAF

Type : VARCHAR | Longueur : 255

Description : Certificat 3D Secure de la transaction.

Équivalent API Formulaire : vads_threeds_cavv

Équivalent API REST : transactionDetails.cardDetails.authenticationResponse.value.authenticationValue.value

Ex :Q**************************=

29 COMPLEMENTARY_INFO

Type : VARCHAR | Longueur : 255

Description : Détail du résultat des contrôles de risque effectués.

Option réservée aux marchands ayant souscrit au module d'aide à la décision.

Équivalent API Formulaire : vads_risk_control

Équivalent API REST : transactionDetails.fraudManagement.riskControl

Valeurs :
  • CARD_COUNTRY=XXX : XXX correspond au code pays ISO 3166 alpha-3 3166.
  • MAESTRO=YES|NO : indique si le moyen de paiement utilisé est une carte Maestro.
  • CAS=YES|NO : indique si le moyen de paiement utilisé est une carte à autorisation systématique.
  • ECBL=YES|NO : indique si le moyen de paiement utilisé est une eCarte-Bleue.
  • CCC=YES|NO : indique si une incohérence entre les pays de l'acheteur, du moyen de paiement et de l'IP de l'acheteur a été détectée.
  • BDOM : Libellé de la banque émettrice du moyen de paiement.
  • PRODUCTCODE : Produit de la carte. Valeurs : Liste des codes produit.
  • BANKCODE : Code banque.

Ex : MAESTRO=NO|ECBL=NO|PRODUCTCODE=MDS

30 BANK_RESPONSE_CODE

Type : VARCHAR | Longueur : 255

Description : Code réponse à la demande d'autorisation envoyé par la banque émettrice.

Équivalent API Formulaire : vads_auth_result

Équivalent API REST : transactionDetails.cardDetails.authorizationResponse.authorizationResult

Valeurs : Liste des codes retour autorisation

Ex : 00

31 3D_LS

Type : VARCHAR | Longueur : 255

Description : Garantie de paiement 3DSecure.

Équivalent API Formulaire : vads_warranty_result

Équivalent API REST : transactionDetails.liabilityShift

Valeurs :
  • YES: Paiement garanti 3D Secure.
  • NO: Paiement non garanti 3D Secure.
  • UNKNOWN: Garantie de paiement non déterminable suite à une erreur technique.

Ex : YES

32 INFO_EXTRA

Type : VARCHAR | Longueur : 4096

Description : Valorisé avec les champs personnalisables permettant d'ajouter des données supplémentaires dans l'e-mail de confirmation envoyé au marchand et dans l'URL de notification (vads_ext_info_).

Équivalent API Formulaire : vads_ext_info

Équivalent API REST : metadata

Ex :

Si vads_ext_info_key1=value1 et vads_ext_info_key2=value2, INFO_EXTRA est valorisé ainsi:

key1=value1|key2 = value2

Exemple de fichier

Téléchargez le pack d'exemples : https://paiement.systempay.fr/doc/files/samples/sample-files.zip.

Vous trouverez un fichier d'exemple dans le dossier Reporting/JT.

© 2025 Tous droits réservés à SystempayMentions légales
25.18-1.11