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 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.

Equivalent API Formulaire: vads_trans_id

Equivalent API REST: cardDetails.legacyTransId

Ex: xrT15p

03 MERCHANT_ID

Type: VARCHAR | Longueur: 255

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

Equivalent API Formulaire: N/A

Equivalent 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)

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Valeur: Toujours valorisé à CARD.

05 CONTRACT

Type: VARCHAR | Longueur: 255

Description: Numéro de contrat du marchand.

Equivalent API Formulaire: vads_contract_used

Equivalent API REST: transactionDetails.mid

Ex: 0535875

06 TRANSACTION_TYPE

Type: VARCHAR | Longueur: 255

Description: Type de transaction.

Equivalent API Formulaire: vads_operation_type

Equivalent 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.

Equivalent API Formulaire: N/A

Equivalent 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.

Equivalent API Formulaire: vads_amount

Equivalent 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).

Equivalent API Formulaire: vads_currency

Equivalent 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.

Equivalent API Formulaire: vads_effective_creation_date

Equivalent API REST: creationDate

Ex: 20200110

11 PAYMENT_TIME

Type: TIME | Longueur: 6

Description: Heure de paiement dans le fuseau UTC.

Equivalent API Formulaire: vads_effective_creation_date

Equivalent API REST: creationDate

Ex: 142512

12 CARD_VALIDITY

Type: NUMERIC | Longueur: 6

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

Equivalent API Formulaire: vads_expiry_year + vads_expiry_month

Equivalent API REST: transactionDetails.cardDetails.expiryYear + transactionDetails.cardDetails.expiryMonth

Ex: 202306

13 CARD_TYPE

Type: VARCHAR | Longueur: 255

Description: Type de carte.

Equivalent API Formulaire: vads_card_brand

Equivalent API REST: transactionDetails.cardDetails.effectiveBrand

Ex: CB, VISA, MASTERCARD, etc.

14 CARD_NUMBER

Description: 6 premiers chiffres du moyen de paiement.

Equivalent API Formulaire: vads_card_number

Equivalent API REST: transactionDetails.cardDetails.pan

Ex: 497014

15 RESPONSE_CODE

Type: NUMERIC | Longueur: 2

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

Equivalent API Formulaire: vads_result

Equivalent 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é.

Equivalent API Formulaire: vads_extra_result

Equivalent 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.

Equivalent API Formulaire: vads_payment_certificate

Equivalent API REST: N/A

Ex: 6ed7b71c023a20adbadf9a2e2c58cd4321f63123

18 AUTORISATION_ID

Type: VARCHAR | Longueur: 6

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

Equivalent API Formulaire: vads_auth_number

Equivalent API REST: transactionDetails.cardDetails.authorizationResponse.authorizationNumber

Ex: 3fc116

19 CAPTURE_DATE

Type: DATE | Longueur: 8

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

Equivalent API Formulaire: vads_presentation_date

Equivalent API REST: transactionDetails.cardDetails.expectedCaptureDate

Ex: 20200107

20 TRANSACTION_STATUS

Type: VARCHAR | Longueur: 255

Description: Statut de la transaction.

Equivalent API Formulaire: vads_trans_status

Equivalent 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.

Equivalent API Formulaire: vads_order_info | vads_order_info2 | vads_order_info3

Equivalent API REST: N/A

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).

Equivalent API Formulaire: N/A

Equivalent 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.

Equivalent API Formulaire: vads_order_id

Equivalent 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.

Equivalent API Formulaire: vads_cust_id

Equivalent API REST: customer.reference

Ex: C2383333540

25 CUSTOMER_IP_ADDRESS

Type: VARCHAR | Longueur: 255

Description: Adresse IP de l'acheteur.

Equivalent API Formulaire: N/A

Equivalent 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 "-".

Equivalent API Formulaire: vads_identifier "-" vads_subscription

Equivalent API REST: paymentMethodToken "-" subscriptionId

Ex: 5fa8d3dede8f4c219c4652dfabe2bf55-20191106ANav0o

27 TRANSACTION_CONDITION

Type: VARCHAR | Longueur: 255

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

Equivalent API Formulaire: N/A

Equivalent 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.

Equivalent API Formulaire: vads_threeds_cavv

Equivalent 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.

Equivalent API Formulaire: vads_risk_control

Equivalent 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: NUMERIC | Longueur: 2

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

Equivalent API Formulaire: vads_auth_result

Equivalent 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.

Equivalent API Formulaire: vads_warranty_result

Equivalent 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_).

Equivalent API Formulaire: vads_ext_info

Equivalent 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.