Format V4

L'enregistrement « TITRE »

Pos.	Description	Valeurs
01	Code d'enregistrement	TITRE
02	Libellé de la boutique tel que défini dans le Back Office Marchand.	Ex : DEMO Store
03	Date et heure UTC de l'envoi (AAMMJJ_HH:MM:SS)	200113_02:05:00
04	Version	TABLE_V4

Les enregistrements « ENTETE » et « DETAILS »

Pos.	Description
01	ENTETE Type : VARCHAR \| Longueur : 9 Description : Code d'enregistrement. Valeur : toujours valorisé à OPERATION
02	MERCHANT_COUNTRY Type : VARCHAR \| Longueur : 2 Description : Code pays de la société (norme ISO 3166-1 alpha-2). Équivalent API Formulaire : N/A Équivalent API REST : N/A Ex : FR pour la France.
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_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
05	TRANSACTION_ID Type : VARCHAR \| Longueur : 255 Description : Identifiant de la transaction. Équivalent API Formulaire : vads_trans_id Équivalent API REST : cardDetails.legacyTransId Ex : xrT15p
06	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
07	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
08	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 : 4525 pour 45,25 EUR
09	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 chapitre Liste des devises supportées)
10	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
11	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
12	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
13	RESPONSE_CODE Type : NUMERIC \| Longueur : 2 Description : Code retour de l'opération demandée. Pour plus de détails, consultez le paramètre BANK_RESPONSE_CODE Valeurs : 00 : Opération acceptée. 05 : Opération refusée. 17: Paiement annulé (uniquement pour un paiement sans autorisation par exemple, lors d'un paiement par prélèvement). 34 : Opération refusée pour suspicion de fraude. 75 : Opération refusée suite au nombre de tentatives de saisie du numéro de carte dépassé. 96 : Opération refusée suite à une erreur technique. Ex : 00
14	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 : Liste des codes retour autorisation Ex : 00
15	CVV_RESPONSE_CODE Type : VARCHAR \| Longueur : 255 Description : Code réponse du CVV2/CVC2. Valeur : Toujours valorisé à vide.
16	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
17	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
18	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.
19	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

L'enregistrement « FIN »

Pos.	Description	Valeurs
01	Code d'enregistrement	FIN

Exemple de fichier

Téléchargez le pack d'exemples : https://sogecommerce.societegenerale.eu/doc/files/samples/sample-files.zip.

Vous trouverez un fichier d'exemple dans le dossier Reporting/JO.