Format V3

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 (AAMMJJ_hh:mm:ss) 200113_02:05:00
04 Version TABLE_V3

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 libéllés de l'enregistrement ENTETE.

Les libellés et les valeurs possibles sont représentés dans le tableau suivant :

Pos. Description
01 ENTETE

Type: VARCHAR | Longueur: 9

Description: Code d'enregistrement.

Valeur: toujours valorisé à OPERATION

02 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

03 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

04 TRANSACTION_ID

Type: VARCHAR | Longueur: 255

Description: Identifiant de la transaction.

Equivalent API Formulaire: vads_trans_id

Equivalent API REST: cardDetails.legacyTransId

Ex: xrT15p

05 OPERATION_SEQUENCE

Type: NUMERIC | Longueur: 1

Description: Numéro de l’opération. Ce champ est toujours valorisé à "1".

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Valeur: 1

06 OPERATION_NAME

Type: VARCHAR | Longueur: 255

Description: Typologie de l’action effectuée

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Valeurs:
  • AUTHOR: Autorisation d’une transaction (dans le cas des paiements différés)
  • CANCEL: Annulation de la transaction
  • CREDIT_CAPTURE: Remise en banque d'une transaction de remboursement
  • DEBIT_CAPTURE: Remise en banque d'une transaction de débit
  • DUPLICATE: Duplication d'une transaction
  • CREDIT: Remboursement d'une transaction
  • EXPIRED: Expiration d'une transaction
  • MODIFICATION: Modification d'une transaction
  • TRANSACTION: Enregistrement d'un paiement manuel
  • TRANSACTION_WITH_MANUAL_VALIDATION: Enregistrement d'un paiement manuel avec validation manuelle.
  • VALIDATE: Validation d'une transaction
  • RAPPROCHEMENT: Rapprochement d'une transaction
  • VERIFICATION_REQUEST: Demande de vérification du moyen de paiement.

Ex: CREDIT

07 OPERATION_AMOUNT

Type: NUMERIC | Longueur: 13

Description: Montant de l’opération 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 OPERATION_CURRENCY

Type: NUMERIC | Longueur: 3

Description: Devise de l’opération

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex: 978 (Voir tableau vads_currency en annexes)

09 OPERATION_DATE

Type: DATE | Longueur: 6

Description: Date UTC de l’opération au format YYMMDD

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex: 200112

10 OPERATION_TIME

Type: TIME | Longueur: 6

Description: Heure UTC de l’opération

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Ex:121327

11 OPERATION_ORIGIN

Type: VARCHAR | Longueur: 255

Description: Identifiant de l’utilisateur ayant réalisé l’action.

Valorisé à « BATCH » s’il s’agit d’une traitement automatisé.

Ex: BATCH

12 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

13 NEW_STATUS

Type: VARCHAR | Longueur: 255

Description: Nouveau statut de la transaction. Ce champ peut être vide si le statut de la transaction ne correspond pas à un des statuts ci-dessous.

Equivalent API Formulaire: N/A

Equivalent API REST: N/A

Valeurs:
  • 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é.

Ex: TO_CAPTURE

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

L'enregistrement « FIN »

Pos. Description Valeurs
01 Code d'enregistrement FIN

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