Format V3

L'enregistrement « TITRE »

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 »

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

É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

03 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

04 TRANSACTION_ID

Type : VARCHAR | Longueur : 255

Description : Identifiant de la transaction.

Équivalent API Formulaire : vads_trans_id

Équivalent 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".

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeur: 1

06 OPERATION_NAME

Type : VARCHAR | Longueur : 255

Description : Typologie de l’action effectuée.

Équivalent API Formulaire : N/A

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

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 3000 pour 30,00 EUR

08 OPERATION_CURRENCY

Type : NUMERIC | Longueur : 3

Description : Devise de l’opération.

Équivalent API Formulaire : N/A

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

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 200112

10 OPERATION_TIME

Type : TIME | Longueur : 6

Description : Heure UTC de l’opération.

Équivalent API Formulaire : N/A

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

É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

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.

Équivalent API Formulaire : N/A

Équivalent 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 "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.

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.