Comprendre la structure du journal des opérations

IMPORTANT

A partir du 13 Novembre 2019, le format des dates évolue.

La valeur des champs OPERATION_DATE, OPERATION_TIME et CAPTURE_DATE ainsi que la date d'envoi présente dans l'entête du fichier sera exprimée dans le fuseau UTC.

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 de l'envoi (AA/MM/JJ_hh:mm:ss)
04 Version TABLE_V3

Les enregistrements « Entête » et « Détails »

L'Entête liste les différents libellés à valoriser dans le journal. Les données de la ligne Détails valorisent, pour chaque transaction, les libéllés de l'enregistrement Entête. Les libellés et les valeurs possibles sont représentés dans le tableau suivant :

Pos. Enregistrement « Entête » Enregistrement « Détails »
Libellé Description Valeur possible Signification
01 ENTETE Code d'enregistrement OPERATION  
02 MERCHANT_ID Identifiant du marchand   Exemples :

0+SIRET (système d'identification du répertoire des établissements) en France.

0+CRN (Company Registration Number) au Royaume-Uni

0+NIF (Numero de Identificación Fiscal) en Espagne

03 PAYMENT_DATE Date de paiement Format AAAAMMJJ
04 TRANSACTION_ID Identifiant de la transaction équivalent à vads_trans_id  
05 OPERATION_SEQUENCE Numéro de l’opération    
06 OPERATION_NAME Typologie de l’action effectuée MERCHANT_BO_CHECK_URL Invocation de la check URL de notification :
  • lors du paiement, de la modification ou de la duplication
BATCH_AUTO_CHECK_URL
  • lors de l'autorisation via les tâches
RECURRENCE_CHECK_URL
  • lors du paiement par récurrences
FILE_CHECK_URL
  • lors du paiement par fichier d'identifiants
PAYMENT_CHECK_URL
  • lors du paiement
MANUAL_CHECK_URL Invocation manuelle de la check URL de notification sur une transaction existante
ADVICE Principe de forcer la transaction
AUTHOR Autorisation d’une transaction (dans le cas où l’autorisation n’est pas effectuée en temps réel)
CANCEL Annulation de la transaction
CREDIT_CAPTURE Remise en banque :
  • d’un remboursement
DEBIT_CAPTURE
  • d’un paiement
DUPLICATE Duplication de transaction
CREDIT Remboursement d’une transaction
EXPIRED Expiration d’une transaction
MODIFICATION Modification d’une transaction
TRANSACTION Saisie d’un paiement manuel
VALIDATE Validation d’une transaction
WAIT Mise en attente d’une transaction
REACTIVATION Réactivation de transaction
07 OPERATION_AMOUNT Montant de l’opération exprimé dans la plus petite unité de la devise    
08 OPERATION_CURRENCY Devise de l’opération  

Voir tableau vads_currency pour plus d'exemples.

09 OPERATION_DATE Date de l’opération    
10 OPERATION_TIME Heure de l’opération    
11 OPERATION_ORIGIN Identifiant de l’utilisateur ayant réalisé l’action.   Valorisé à « Batch » s’il s’agit d’une traitement automatisé
12 RESPONSE_CODE Code réponse à la demande d’autorisation

Voir chapitre vads_auth_result

13 NEW_STATUS Nouveau statut de l’opération REFUSED Transaction refusée
AUTHORISED_TO_VALIDATE Transaction à valider
AUTHORISED Transaction en attente de remise
CANCELLED Transaction annulée
CAPTURED Transaction remisée
EXPIRED Transaction expirée
WAITING_AUTHORISATION_TO_VALIDATE Transaction à valider et autoriser
WAITING_AUTHORISATION Transaction en attente de demande d’autorisation
UNDER_VERIFICATION Transaction en cours de vérification
CAPTURE_FAILED La remise de la transaction a échoué.
14 RETURN_CONTEXT Contexte de la commande d’un acheteur   Une ou plusieurs informations (order_info, order_info2, order_info3, ...) séparées par le caractère « | »

L'enregistrement « Fin »

Pos. Description Valeurs
01 Code d'enregistrement FIN

Exemple de fichier

Cet extrait de journal des opérations (JO) montre :

  • une ligne d'enregistrement Titre,
  • une ligne d'enregistrement Entête,
  • deux lignes d'enregistrement Détails commençant chacune par OPERATION,
  • une ligne d'enregistrement Fin marquant la fin du document.
TITRE;PayZen;16/04/08_14:53:25;TABLE_V3;
ENTETE;MERCHANT_ID;PAYMENT_DATE;TRANSACTION_ID;OPERATION_SEQUENCE;OPERATION_NAME;
OPERATION_AMOUNT;OPERATION_CURRENCY;OPERATION_DATE;OPERATION_TIME;OPERATION_ORIGIN;
RESPONSE_CODE;NEW_STATUS;
OPERATION;005008588532646;20110205;998174;1;DUPLICATE;9900;978;090205;121327;
test;00;AUTHORISED;;
OPERATION;005008588532646;20110205;998174;2;CANCEL;9900;978;090205;121400;
test;00;CANCELLED;;
FIN;