Format

L'enregistrement « TITRE »

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

Pos. Description Valeurs
01 Code d'enregistrement TITRE
02 Nom de la boutique
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 »

La ligne ENTETE liste les différents libellés à valoriser dans le journal. Les données de la ligne DETAILS valorisent, pour chaque transaction, les libellés de l'enregistrement ENTETE.

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. (Obsolète).

É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 : 3000 pour 30,00 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 : 3000 pour 30,00 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

Ex : 978 pour l'euro (EUR) (Voir tableau vads_currency en annexes)

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.

Équivalent API Formulaire : vads_card_brand

Équivalent API REST : transactionDetails.cardDetails.effectiveBrand

Ex : CB, VISA, MASTERCARD, etc.

14 CARD_NUMBER

Description : 6 premiers chiffres du moyen de paiement.

Équivalent API Formulaire : vads_card_number

Équivalent API REST : transactionDetails.cardDetails.pan

Ex : 497014

15 RESPONSE_CODE

Type : NUMERIC | Longueur : 2

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

Équivalent API Formulaire : vads_result

Équivalent API REST : N/A

Valeurs :
  • 00 : Autorisation acceptée.
  • 05 : Autorisation refusée.
  • 34 : Suspicion de fraude.
  • 75 : Nombre de tentatives de saisie du numéro de carte dépassé.
  • 96 : Service temporairement indisponible.

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 : 6

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 : Voir chapitre vads_trans_status

Ex : CAPTURED

21 RETURN_CONTEXT

Type : VARCHAR | Longueur : 500

Description : Contexte de la commande d’un acheteur.

Concaténation des valeurs des champs vads_order_info, vads_order_info2, vads_order_info3 du formulaire de paiement, séparées par le caractère "|". Au-delà de 500 caractères, la chaine est tronquée. Champ vide si aucun champ vads_order_info n'est transmis.

Équivalent API Formulaire : vads_order_info | vads_order_info2 | vads_order_info3

Équivalent API REST : metadata : "info" | "info2" | "info3"

Ex :
  • info1|info2|info3 si les 3 champs sont transmis,
  • info1||info3: si seuls vads_order_info 1 et 3 sont transmis.
22 AUTORESPONSE_STATUS

Type : VARCHAR | Longueur : 255

Description : Etat 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

Description : 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 : transactionDetails.cardDetails.threeDSResponse.authenticationResultData.transactionCondition

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.threeDSResponse.authenticationResultData.cavv

Ex :Q2F2dkNhdnZDYXZ2Q2F2dkNhdnY=

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 sourcrit 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é detectée.
  • BDOM : Libellé de la banque émettrice du moyen de paiement.
  • PRODUCTCODE : Produit de la carte.
  • 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 : Voir chapitre vads_auth_result.

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 : 255

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 : N/A

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://payzen.io/files/samples/fr/sample-files.zip.

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