Comprendre la structure du journal des transactions

L'enregistrement « Titre »

L'enregistrement Titre renseigne sur les caractéristiques du fichier pour permettre une meilleure identifcation. Il est valorisé comme suit :

Pos. Description Valeurs
01 Code d'enregistrement TITRE
02 Nom de la boutique
03 Date et heure de l'envoi (AA/MM/JJ_hh:mm:ss)
04 Version TABLE_V_CUSTOM

Les enregistrements « Entête » et « Détails »

L'Entête liste les différents libellés à valoriser dans le journal. Les données de la ligne Détails valorisent, pour chaque transaction, les libéllés de l'enregistrement Entête. Les libellés et les valeurs possibles sont représentés dans le tableau suivant :

Pos. Enregistrement « Entête » Enregistrement « Détails »
Libellé Description Valeur possible Signification
01 ENTETE Code d'enregistrement TRANSACTION  
02 TRANSACTION_ID Identifiant de la transaction équivalent à vads_trans_id  
03 MERCHANT_ID Identifiant du marchand   Exemples :

0+SIRET (système d'identification du répertoire des établissements) en France.

0+CRN (Company Registration Number) au Royaume-Uni

0+NIF (Numero de Identificación Fiscal) en Espagne

04 PAYMENT_MEANS Moyen de paiement CARD Transaction par carte
05 CONTRACT Numéro de contrat du marchand    
06 TRANSACTION_TYPE Type de transaction CREDIT Remboursement
DEBIT Débit
VERIFICATION Transaction de vérification
07 ORIGIN_AMOUNT Montant de la transaction au moment du paiement exprimé dans la plus petite unité de la devise    
08 AMOUNT Solde de la transaction exprimé dans la plus petite unité de la devise    
09 CURRENCY_CODE Code de la devise de la transaction  

Voir tableau vads_currency pour plus d'exemples.

10 PAYMENT_DATE Date de paiement   Format AAAAMMJJ
11 PAYMENT_TIME Heure de paiement   Format hhmmss
12 CARD_VALIDITY Période de validité du moyen de paiement   Format AAAAMM
13 CARD_TYPE Moyen de paiement   Exemples : CB, VISA, MASTERCARD, etc.
14 CARD_NUMBER Extrait du numéro de carte utilisé pour le paiement    
15 RESPONSE_CODE Code réponse à la demande d'autorisation

Voir chapitre vads_auth_result

 
16 COMPLEMENTARY_CODE Résultat de la gestion des risques (spécifique aux boutiques ayant souscrit au module) vide Pas de contrôle effectué
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
17 CERTIFICATE Certificat de la transaction    
18 AUTORISATION_ID Numéro d'autorisation de la transaction    
19 CAPTURE_DATE Date d'envoi en banque demandée   Format AAAAMMJJ
20 RETURN_CONTEXT Contexte de la commande d’un acheteur   Une ou plusieurs informations (order_info, order_info2, order_info3, ...) séparées par le caractère « | »
21 AUTORESPONSE_STATUS Etat de l'envoi de la réponse automatique FAILED Réponse automatique transmise au serveur du marchand a échoué
SENT Réponse automatique envoyée au serveur du marchand
UNDEFINED Aucune réponse automatique n’a été demandée par le marchand
22 ORDER_ID Référence commande - Équivalent à vads_order_id    
23 CUSTOMER_ID Identifiant de l'acheteur - Équivalent à vads_cust_id    
24 CUSTOMER_IP_ADDRESS Adresse IP de l'acheteur    
25 ACCOUNT_SERIAL N° d'abonné suivi du n° éventuel d'abonnement - Équivalent à vads_identifier et vads_subscription    
26 TRANSACTION_CONDITION Résultat de l'authentification 3D Secure 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 pas authentifié :
  • soit type de carte pas supporté par 3D Secure
  • soit marchand ou porteur pas inscrit à 3D Secure
27 CAVV_UCAF Certificat 3D Secure   3D Secure Cardholder Authentication Verification Value
28 COMPLEMENTARY_INFO Détail du résultat des contrôles locaux effectués.

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

CARD_COUNTRY=XXX XXX correspond au code pays Iso alphabétique 3166
MAESTRO Valeur = YES | NO
CAS (Carte à Autorisation Systématique) Valeur = YES | NO
ECBL (E-carte bleue) Valeur = YES | NO
CCC (Country Card Consistency) Valeur = YES | NO
BDOM Nom de la banque
PRODUCTCODE Produit de la carte
BANKCODE Code banque
29 BANK_RESPONSE_CODE Code réponse de la banque émettrice de la demande d'autorisation Voir chapitre vads_auth_result
30 3D_LS Garantie de paiement 3DSecure YES Paiement garanti 3D Secure
NO Paiement non garanti 3D Secure
UNKNOWN Garantie de paiement non déterminable suite à une erreur technique
31 INFO_EXTRA      

Exemple de fichier

Cet extrait de Journal des Transactions (JT) montre :

  • une ligne d'enregistrement Titre,
  • une ligne d'enregistrement Entête,
  • deux lignes d'enregistrement Détails commençant chacune par TRANSACTION.
TITRE;Lyra Collect;16/04/08_14:53:25;TABLE_V_CUSTOM;
ENTETE;TRANSACTION_ID;MERCHANT_ID;PAYMENT_MEANS;CONTRACT;
ORIGIN_AMOUNT;AMOUNT;CURRENCY_CODE;PAYMENT_DATE;PAYMENT_TIME;CARD_VALIDITY;
CARD_TYPE;CARD_NUMBER;RESPONSE_CODE;COMPLEMENTARY_CODE;CERTIFICATE;AUTORISATION_ID;
CAPTURE_DATE;TRANSACTION_STATUS;RETURN_CONTEXT;AUTORESPONSE_STATUS;ORDER_ID;CUSTOMER_ID;
CUSTOMER_IP_ADDRESS;ACCOUNT_SERIAL;SESSION_ID;TRANSACTION_CONDITION;CAVV_UCAF;
COMPLEMENTARY_INFO;BANK_RESPONSE_CODE;3D_LS;INFO_EXTRA;
TRANSACTION;000001;000000000006523;CARD;2348858;9920;9920;978;20160208;095106;201802;
CB;4533.66;00;;4eb30dbd0968da1986024791f8a9cd53725bd6dce34774;349382;20160208;CAPTURED;
https://www.xxxxxx.com|https://www.xyyyyx.com|;SENT;20160222;;170.000.000.000;;MA_SESSION;
SSL;;| Maestro=NO | BANKCODE=my banking establishment | PRODUCTCODE=F | ;00;NO;;
TRANSACTION;000002;000000000006523;CARD;2348858;9920;9920;978;20160208;095304;201711;
CB;5136.49;00;;d32b4e69c5ed7e72b9c852737133bd1a1a;546203;20160208;CAPTURED;
https://www.zzzzzzzz.com|https://www.zxxyyz.com;SENT;20160211;;80.15.00.00;;MA_SESSION;SSL;;
| Maestro=NO|BANKCODE= my bank| PRODUCTCODE=MDS | ;00;NO;;