DESCRIPTION DES JOURNAUX DE REPORTING

Transcription

1 DESCRIPTION DES JOURNAUX DE REPORTING Version 2.1b 18/07/2013 Ce document et son contenu sont strictement confidentiels et la propriété de Natixis Paiements. Il n est pas contractuel. Toute reproduction et/ou distribution de ce document ou de toute ou partie de son contenu à une entité tiers sont strictement interdits ou sujet à une autorisation écrite préalable de Natixis Paiements. Tous droits réservés

2 SOMMAIRE 1. INTRODUCTION REGLE DE NOMMAGE DES FICHIERS PERIODICITE JOURNALIERE PERIODICITE HEBDOMADAIRE PERIODICITE MENSUELLE JOURNAUX PRE-FORMATES COMMENT LES UTILISER? PROCEDURES DE MISE A DISPOSITION JOURNAL DES TRANSACTIONS Structure du fichier Exemple de fichier JOURNAL DES OPERATIONS Structure du fichier V Exemple de fichier V Structure du fichier V JOURNAL DE RAPPROCHEMENT BANCAIRE Structure du fichier Exemple de fichier JOURNAL DE RAPPROCHEMENT DES IMPAYES Structure du fichier AUTRES TYPOLOGIES DE REPORTING GENERALITES SUR L EXPORTATION DE DONNEES VIA L OUTIL DE GESTION DE CAISSE EXPORT DES «PAIEMENTS EN COURS» EXPORT DES «REMISES» EXPORT DES «PAIEMENTS REMISES» Description des journaux de reporting Copyright Natixis Paiements page 2/38

3 1. INTRODUCTION Afin d aider le commerçant dans sa gestion quotidienne, différents niveaux de reporting sont proposés. Tous restituent l identifiant de transaction initialement positionné par le marchand dans la donnée trans_id de la requête de paiement. NB : Ce numéro est automatiquement généré par la plateforme pour les paiements manuels. Ces reportings peuvent avoir lieu en temps réel, ou en léger différé, en fonction de leur typologie. Par défaut, il vous est proposé la mise à disposition de journaux pré-formatés et la possibilité de réaliser des exportations personnalisées depuis votre outil de gestion de caisse. Tous ces reportings sont disponibles que la boutique soit en TEST ou en PRODUCTION. Les reporting de TEST sont mis à disposition à titre indicatif. 2. REGLE DE NOMMAGE DES FICHIERS 2.1. Périodicité journalière Nom du fichier : CODE_LIBELLE-DE-LA-BOUTIQUE_IDENTIFIANT-DU-SITE_DATE_VERSION.csv Avec CODE : Initiale du journal = JO / JT / JRB /JRI LIBELLE-DE-LA-BOUTIQUE : Nom de la boutique (en majuscule) tel qu il est défini dans l outil de gestion de caisse (paramétrage / Boutique /Configuration). Les espaces sont remplacés par le caractère «_». IDENTIFIANT-DU-SITE : Identifiant du site sur 8 chiffres, visible dans l outil de gestion de caisse (paramétrage / Boutique /Configuration). DATE : Date de génération du journal au format AAMMJJ. VERSION : V1, V3 ou V7 en fonction du type de journal. Exemples des journaux du 18/09/2012 de la boutique «boutique de démo» (identifiant ) : JO_BOUTIQUE_DE_DEMO_ _120918_V3.csv JT_BOUTIQUE_DE_DEMO_ _120918_V7.csv En mode TEST, le nom du fichier est préfixé par «TEST_» Description des journaux de reporting Copyright Natixis Paiements page 3/38

4 2.2. Périodicité hebdomadaire Nom du fichier : CODE_LIBELLE-DE-LA-BOUTIQUE_IDENTIFIANT-DU-SITE_SEMAINE_VERSION.csv Avec CODE : Initiale du journal = JO / JT / JRB /JRI LIBELLE-DE-LA-BOUTIQUE : Nom de la boutique (en majuscule) tel qu il est défini dans l outil de gestion de caisse (paramétrage / Boutique /Configuration). Les espaces sont remplacés par le caractère «_». IDENTIFIANT-DU-SITE : Identifiant du site sur 8 chiffres, visible dans l outil de gestion de caisse (paramétrage / Boutique /Configuration). SEMAINE : Semaine de génération du journal au format AAWXX. AA l année (12 pour 2012) / W pour week (semaine) / XX pour le numéro de la semaine. VERSION : V1, V3 ou V7 en fonction du type de journal. Exemples des journaux pour la semaine 32 de 2012 de la boutique «boutique de démo» (identifiant ) : JO_BOUTIQUE_DE_DEMO_ _12W32_V3.csv JT_BOUTIQUE_DE_DEMO_ _12W32_V7.csv En mode TEST, le nom du fichier est préfixé par «TEST_» Description des journaux de reporting Copyright Natixis Paiements page 4/38

5 2.3. Périodicité mensuelle Nom du fichier : CODE_LIBELLE-DE-LA-BOUTIQUE_IDENTIFIANT-DU-SITE_MOIS_VERSION.csv Avec CODE : Initiale du journal = JO / JT / JRB /JRI LIBELLE-DE-LA-BOUTIQUE : Nom de la boutique (en majuscule) tel qu il est défini dans l outil de gestion de caisse (paramétrage / Boutique /Configuration). Les espaces sont remplacés par le caractère «_». IDENTIFIANT-DU-SITE : Identifiant du site sur 8 chiffres, visible dans l outil de gestion de caisse (paramétrage / Boutique /Configuration). MOIS: Mois de génération du journal au format AAMXX. AA l année (12 pour 2012) / M pour month (mois) / XX pour le numéro du mois. VERSION : V1, V3 ou V7 en fonction du type de journal. Exemples des journaux pour le mois de mai 2012 de la boutique «boutique de démo» (identifiant ) : JO_BOUTIQUE_DE_DEMO_ _12M05_V3.csv JT_BOUTIQUE_DE_DEMO_ _12M05_V7.csv En mode TEST, le nom du fichier est préfixé par «TEST_» Description des journaux de reporting Copyright Natixis Paiements page 5/38

6 3. JOURNAUX PRE-FORMATES 3.1. Comment les utiliser? Quatre typologies de journaux pré-formatés peuvent être mises à disposition : le journal des transactions, le journal des opérations, le journal de rapprochement bancaire. le journal de rapprochement des impayés. Le journal des transactions vous informe de tous les paiements effectués (acceptés et refusés) sur votre boutique. Grâce à un outil de traitement automatique, ou manuellement, vous pouvez analyser ces fichiers et mettre à jour vos bases de données. De cette manière, vous vous assurez de livrer toutes les commandes acceptées en paiement. Le journal des opérations vous informe de l évolution du cycle de vie des transactions. Là aussi, vous pouvez analyser ces fichiers et mettre à jour vos bases de données. Le journal de rapprochement bancaire (JRB) permet à un commerçant de rapprocher les transactions réalisées sur la plateforme de paiement avec les paiements apparaissant sur son relevé bancaire. Ce journal apporte des informations bancaires complémentaires (montant crédité sur le compte, commission, etc.). Le journal de rapprochement des impayés (JRI) permet à un commerçant de rapprocher les transactions réalisées sur la plateforme de paiement avec les impayés qu il reçoit Procédures de mise à disposition Par défaut, les journaux des transactions et des opérations sont mis à disposition une fois par jour entre 4h00 et 7h00. Les journaux sont au format «.CSV». Les modalités de restitution de ces fichiers sont à tout moment personnalisables par les commerçants grâce à l onglet «paramétrage» de l outil de gestion de caisse. Selon les paramétrages retenus, ces journaux peuvent être : Quotidiens ou hebdomadaires ou mensuels, transférés en pièce jointe à une ou plusieurs adresses de votre choix paramétrables dans l outil de gestion de caisse. NB : Sur demande du commerçant, la mise à disposition de ces fichiers peut également être réalisée en FTP. Les fichiers seront alors déposés dans le répertoire /log Description des journaux de reporting Copyright Natixis Paiements page 6/38

7 3.3. Journal des transactions Structure du fichier Généralités Le fichier est au format CSV. Le fichier peut être ouvert dans Excel sous forme d un tableau. Chaque fichier est structuré de la façon suivante : - Un enregistrement «Titre» - Un enregistrement «Entête» - N enregistrements détails (où N correspond au nombre de transactions contenues dans le fichier). NB : il n y a pas de fin d enregistrement dans le journal des transactions v7 Un exemple de journal, mettant en évidence cette structure, est présenté au Enregistrement «titre» L enregistrement «Titre» fournit les caractéristiques du fichier. Sa valorisation est la suivante : Position Description Valorisation dans l enregistrement «titre» 1 Code enregistrement = TITRE 2 Nom de la boutique 3 Date et heure de l envoi (AA/MM/JJ_hh :mm :ss) 4 Format et version = Table_V7 Description des journaux de reporting Copyright Natixis Paiements page 7/38

8 Enregistrements «entête» et «détails» L enregistrement «Entête» récapitule les libellés des données transmises. Les enregistrements «détails» contiennent, pour chaque transaction, la valorisation des données précédemment listées dans l enregistrement «entête». Position Libellé de la donnée Description de la donnée (=colonne si tableau) Valorisation dans l enregistrement «détail» Valorisation possible Signification 1 ENTETE Code enregistrement 2 TRANSACTION_ID Identifiant de la transaction 3 MERCHANT_ID Identifiant du commerçant 0 + SIRET 4 PAYMENT_MEANS Moyen de paiement Card Transactions par carte ORIGIN_AMOUNT AMOUNT CURRENCY_CODE PAYMENT_DATE PAYMENT_TIME CARD_VALIDITY Montant de la transaction au moment du paiement exprimé dans la plus petite unité de la devise Solde de la transaction exprimé dans la plus petite unité de la devise 11 CARD_TYPE Type de carte 12 CARD_NUMBER 13 RESPONSE_CODE Code devise de la transaction (ex : 978 = Euro) Date de paiement (AAAAMMJJ) Heure de paiement (hhmmss) Date de validité de la carte (AAAAMM) Extrait du numéro de carte utilisé pour le paiement Code réponse à la demande d autorisation avec la même valeur que BANK_RESPONSE_CODE si la valeur est (00, 02, 05, 30, 34, 75, 96) et à 05 sinon. 00 Autorisation acceptée 02 Le commerçant doit contacter la banque du porteur 05 Autorisation refusée 30 Erreur de format. 34 Suspicion de fraude 75 Nombre de tentatives de saisie du numéro de carte dépassé. 96 Erreur technique lors du paiement 4E 4D Cryptogramme visuel incorrect Cryptogramme visuel correct 14 CVV_RESPONSE_CODE Code réponse à la demande de vérification du CVV2/CVC2 50 Cryptogramme visuel non traité Cryptogramme visuel absent de la demande d'autorisation La banque de l'internaute n'est pas certifiée, le contrôle n'a pas pu être effectué NO Pas de cryptogramme sur la carte Description des journaux de reporting Copyright Natixis Paiements page 8/38

9 vide Pour les cartes AMEX, American Express ne retourne pas de code réponse spécifique à la vérification du numéro de contrôle. Si le Cryptogramme visuel de la carte est faux, American Express retourne un code 05 dans le champ RESPONSE_CODE vide 00 Pas de contrôle effectué Tous les contrôles se sont déroulés avec succès 02 La carte a dépassé l encours autorisé 15 COMPLEMENTARY_CODE Résultat des contrôles locaux effectués La carte appartient à la liste grise du commerçant Le pays d émission de la carte appartient à la liste grise du commerçant ou le pays d émission de la carte n appartient pas à la liste blanche du commerçant. L adresse IP appartient à la liste grise du commerçant La carte appartient à la liste grise BIN du commerçant 07 Contrôle e-carte bleue 16 CERTIFICATE Certificat de la transaction 17 AUTORISATION_ID 18 CAPTURE_DATE Numéro d autorisation de la transaction Date d envoi en banque demandée (AAAAMMJJ) 08 Transaction non garantie 3DS REFERRAL REFUSED Contrôle carte à autorisation systématique Contrôle cohérence pays entre le pays émission de la carte, l adresse IP et le pays de l adresse du client. Problème technique rencontré par le serveur lors du traitement d un des contrôles locaux Transaction à forcer Transaction refusée 19 TRANSACTION_STATUS Etat de la transaction au moment de la génération du journal TO_VALIDATE TO_CAPTURE TO_CREDIT CANCELLED Transaction à valider Transaction de paiement en attente de remise Transaction de crédit en attente de remise Transaction annulée CAPTURED Transaction remisée EXPIRED Transaction expirée WAITING TO_AUTHORIZE Transaction en attente Transaction en attente de demande d autorisation Description des journaux de reporting Copyright Natixis Paiements page 9/38

10 20 RETURN_CONTEXT 21 AUTORESPONSE_STATUS Contexte de la commande d un acheteur Etat de l envoi de la réponse automatique 22 ORDER_ID Numéro de commande 23 CUSTOMER_ID Identifiant du client 24 CUSTOMER_IP_ADDRESS Adresse IP de l internaute 25 ACCOUNT_SERIAL 26 SESSION_ID 27 TRANSACTION_CONDITION 28 CAVV_UCAF 29 COMPLEMENTARY_INFO N d abonné suivi du n éventuel de récurrence Nom de la plateforme de paiement Condition de réalisation de la transaction Certificat 3D-SECURE (3-D Secure Cardholder Authentication Verification Value) Détail du résultat des contrôles locaux effectués (spécifique aux commerçants ayant souscrit order_info1, order_info2, order_info3, séparés par le caractère et délestés des caractères de contrôle (tabulations, retours à la ligne) FAILED SENT UNDEFINED vide SYSTEMPAY 3D_SUCCESS 3D_FAILURE 3D_ERROR 3D_NOTENROLLED 3D_ATTEMPT SSL CARD_COUNTRY=XXX MAESTRO CAS L envoi de la réponse automatique transmise au serveur commerçant a échoué Réponse automatique envoyée au serveur commerçant Aucune réponse automatique n a été demandée par le commerçant Le commerçant et le porteur de la carte sont inscrits au programme 3-D Secure et le porteur s est authentifié correctement. Le commerçant et le porteur de la carte sont inscrits au programme 3-D Secure mais l acheteur n a pas réussi à s authentifier (mauvais mot de passe). Le commerçant participe au programme 3-D Secure mais un problème technique a été rencontré durant le processus d authentification (lors de la vérification de l inscription de la carte au programme 3D ou de l authentification du porteur). Le commerçant participe au programme 3-D Secure mais la carte du porteur n est pas enrôlée. Le commerçant et le porteur de la carte sont inscrits au programme 3-D Secure mais l acheteur n a pas eu à s authentifier (le serveur de contrôle d accès de la banque qui a émis la carte n implémente que la génération d une preuve de tentative d authentification). L acheteur ne s est pas authentifié pour une des raisons suivantes : - le type de carte n est pas supporté par le programme 3-D Secure - le commerçant ou le porteur de la carte n est pas inscrit au programme 3-D Secure XXX correspond au code pays iso alphabétique 3166 Valeur = YES NO Carte à Autorisation Systématique Valeur = YES NO Description des journaux de reporting Copyright Natixis Paiements page 10/38

11 au module d aide à la décision) ECBL CCC BDOM PRODUCTCODE BANKCODE E-carte bleue Valeur = YES NO Country Card Consistency (cohérence des pays de la carte, ip utilisateur et pays du client) Valeur = YES NO Nom de la banque Produit de la carte Code banque Valorisation pour les cartes CB, VISA, MASTERCARD 00 transaction approuvée ou traitée avec succès 02 contacter l'émetteur de la carte 30 BANK_RESPONSE_CODE Code réponse de la banque émettrice à la demande d autorisation 03 accepteur invalide 04 conserver la carte 05 ne pas honorer 07 conserver la carte, conditions spéciales 08 approuver après identification 12 transaction invalide 13 montant invalide 14 numéro de porteur invalide 15 émetteur de carte inconnu 17 annulation client 19 répéter la transaction ultérieurement 20 réponse erronée (erreur dans le domaine serveur) 24 mise à jour de fichier non supportée impossible de localiser l enregistrement dans le fichier enregistrement dupliqué, anicien enregistrement remplacé erreur en «edit» sur champ de mise à jour fichier 28 accès interdit au fichier 29 mise à jour fichier impossible 30 erreur de format 31 identifiant de l'organisme acquéreur inconnu 33 date de validité de la carte dépassée 34 suspicion de fraude carte perdue 43 carte volée 51 nombre d essai code confidentiel dépassé provision insuffisante ou crédit dépassé 54 date de validité de la carte dépassée 55 code confidentiel erroné Description des journaux de reporting Copyright Natixis Paiements page 11/38

12 31 MODE_REGLEMENT Mode de règlement vide 56 carte absente du fichier 57 transaction non permise à ce porteur 58 transaction interdite au terminal 59 suspicion de fraude 60 l'accepteur de la carte doit contacter l'acquéreur 61 montant de retrait hors limite 63 règles de sécurité non respectées réponse non parvenue ou reçue trop tard nombre d essai code confidentiel dépassé porteur déjà en opposition, ancien enregistrement conservé 90 arrêt momentané du système 91 émetteur de carte inaccessible 94 transaction dupliquée 96 mauvais fonctionnement du système échéance de la temporisation de surveillance globale serveur indisponible routage réseau demandé à nouveau 99 incident domaine initiateur 00 Valorisation pour les cartes AMEX Transaction approuvée ou traitée avec succès 02 Dépassement de plafond 04 Conserver la carte 05 Ne pas honorer 97 YES Échéance de la temporisation de surveillance globale Non valorisé pour carte CB, Visa, MasterCard, Amex Paiement 3D-Secure garanti 32 3D_LS Garantie de paiement 3D- Secure NO UNKNOWN Paiement non garanti 3D Secure Garantie de paiement non déterminable suite à une erreur technique Description des journaux de reporting Copyright Natixis Paiements page 12/38

13 Format de champs Position Description Format 1 ENTETE a11 2 TRANSACTION_ID an6 3 MERCHANT_ID n PAYMENT_MEANS ans ORIGIN_AMOUNT n AMOUNT n CURRENCY_CODE n3 8 PAYMENT_DATE n8 9 PAYMENT_TIME n6 10 CARD_VALIDITY n6 11 CARD_TYPE ans CARD_NUMBER n RESPONSE_CODE n2 14 CVV_RESPONSE_CODE n2 15 COMPLEMENTARY_CODE n2 16 CERTIFICATE ans AUTORISATION_ID an CAPTURE_DATE n8 19 TRANSACTION_STATUS ans..32 (enum) 20 RETURN_CONTEXT ans AUTORESPONSE_STATUS ans ORDER_ID an CUSTOMER_ID an CUSTOMER_IP_ADDRESS n ACCOUNT_SERIAL an SESSION_ID an TRANSACTION_CONDITION ans..20 (enum) 28 CAVV_UCAF ans COMPLEMENTARY_INFO ans..255 (enum) 30 BANK_RESPONSE_CODE n2 31 MODE_REGLEMENT vide 32 3D_LS a Exemple de fichier TITRE;NATIXIS;11/02/04_14:46:00;TABLE_V7; ENTETE;TRANSACTION_ID;MERCHANT_ID;PAYMENT_MEANS;ORIGIN_AMOUNT;AMOUNT;CURRENCY _CODE;PAYMENT_DATE;PAYMENT_TIME;CARD_VALIDITY;CARD_TYPE;CARD_NUMBER;RESPONSE_C ODE;CVV_RESPONSE_CODE;COMPLEMENTARY_CODE;CERTIFICATE;AUTORISATION_ID;CAPTURE_D ATE;TRANSACTION_STATUS;RETURN_CONTEXT;AUTORESPONSE_STATUS;ORDER_ID;CUSTOMER_ID; CUSTOMER_IP_ADDRESS;ACCOUNT_SERIAL;SESSION_ID;TRANSACTION_CONDITION;CAVV_UCAF;CO MPLEMENTARY_INFO;BANK_RESPONSE_CODE;MODE_REGLEMENT;3D_LS; TRANSACTION;946439; ;CARD;10520;10520;978; ;094445;201009;VISA; ;0 0;;;;690967; ;CAPTURED;;SENT;468899;; ;;;;;;00;;; TRANSACTION;932155; ;CARD;9900;9900;978; ;100615;201009;VISA; ;00;; ;;974425; ;CAPTURED;;SENT;798001;; ;;;;;;00;;; TRANSACTION;978829; ;CARD;2810;2810;978; ;100704;201009;VISA; ;00;; ;;024718; ;CAPTURED;;SENT;878062;; ;;;;;;00;;; TRANSACTION;944942; ;CARD;5235;5235;978; ;100734;201009;VISA; ;00;; ;;057264; ;CAPTURED;;SENT;678605;; ;;;;;;00;;; Légende : Enregistrement «Titre» Enregistrement «Entête» Enregistrements détails (4 enregistrements dans l exemple ci-dessous) Description des journaux de reporting Copyright Natixis Paiements page 13/38

14 3.4. Journal des opérations Structure du fichier V3 Généralités Le fichier est au format CSV. Il est possible de choisir le séparateur (tabulation, point-virgule, etc.). Le fichier peut être ouvert dans Excel sous forme d un tableau. Chaque fichier est structuré de la façon suivante : - Un enregistrement «Titre» - Un enregistrement «Entête» - N enregistrements détails (où N correspond au nombre de transactions contenues dans le fichier). - Un enregistrement «Fin» Un exemple de journal, mettant en évidence cette structure, est présenté au Enregistrement «titre» : L enregistrement «Titre» fournit les caractéristiques du fichier. Sa valorisation est la suivante : Position Description Valorisation dans l enregistrement «titre» 1 Code enregistrement = TITRE 2 Nom de la boutique 3 Date et heure de l envoi (AA/MM/JJ_hh :mm :ss) 4 Format et version VERSION_V3 Entête et Détail de l enregistrement L enregistrement «Entête» récapitule les libellés des données transmises. Les enregistrements «détails» contiennent, pour chaque opération, la valorisation des données précédemment listées dans l enregistrement «entête». Position Libellé de la donnée 1 ENTETE 2 MERCHANT_ID 3 PAYMENT_DATE Description de la donnée (=colonne si tableau) Code enregistrement Identifiant du commerçant Date de paiement (AAAAMMJJ) Valorisation dans l enregistrement «détail» Valorisation possible Signification 0 + SIRET Description des journaux de reporting Copyright Natixis Paiements page 14/38

15 Position Libellé de la donnée 4 TRANSACTION_ID 5 OPERATION_SEQUENCE 6 OPERATION_NAME Description de la donnée (=colonne si tableau) identifiant de la transaction Numéro de l opération Typologie de l action effectuée. montant de l opération OPERATION_AMOUNT exprimé dans la plus petite unité 7 de la devise devise de OPERATION_CURRENCY 8 l opération 9 OPERATION_DATE date de l opération heure de OPERATION_TIME 10 l opération ID de l utilisateur OPERATION_ORIGIN ayant réalisé 11 l action. 12 RESPONSE_CODE Code réponse à la demande d autorisation Valorisation dans l enregistrement «détail» Valorisation possible MERCHANT_BO_CHECK_URL BATCH_AUTO_CHECK_URL RECURRENCE_CHECK_URL FILE_CHECK_URL PAYMENT_CHECK_URL, MANUAL_CHECK_URL ADVICE AUTHOR CANCEL CREDIT_CAPTURE DEBIT_CAPTURE DUPLICATE CREDIT EXPIRED MODIFICATION TRANSACTION VALIDATE WAIT REACTIVATION Signification Invocation de la check URL lors du paiement, modification, duplication depuis le BO Invocation de la check URL lors de l'autorisation via les tâches Invocation de la check URL lors du paiement par récurrences Invocation de la check lors du paiement par fichier d'identifiants Invocation de la check URL lors du paiement Invocation manuelle de la check URL depuis le BO sur une transaction existante Forçage de transaction Autorisation d une transaction (dans le cas où l autorisation n est pas effectuée en temps réel) Annulation de la transaction Remise en banque d un remboursement Remise en banque d un paiement Duplication de transaction Remboursement d une transaction Expiration d une transaction Modification d une transaction Saisie d un paiement manuel Validation d une transaction Mise en attente d une transaction Réactivation de transaction Valorisé à «Batch» s il s agit d une traitement automatisé 00 Autorisation acceptée 02 Le commerçant doit contacter la banque du porteur 05 Autorisation refusée Description des journaux de reporting Copyright Natixis Paiements page 15/38

16 Position Libellé de la donnée 13 NEW_STATUS 14 RETURN_CONTEXT Description de la donnée (=colonne si tableau) Nouveau statut de l opération Contexte de la commande d un acheteur Valorisation dans l enregistrement «détail» Valorisation possible Signification 30 Erreur de format. 34 Suspicion de fraude Nombre de tentatives de 75 saisie du numéro de carte dépassé. 96 Erreur technique lors du paiement REFERRAL Transaction à forcer REFUSED TO_VALIDATE TO_CAPTURE TO_CREDIT CANCELLED CAPTURED EXPIRED WAITING TO_AUTHORIZE order_info1, order_info2, order_info3, séparés par le caractère et délestés des caractères de contrôle (tabulations, retours à la ligne) Transaction refusée Transaction à valider Transaction de paiement en attente de remise Transaction de crédit en attente de remise Transaction annulée Transaction remisée Transaction expirée Transaction en attente Transaction en attente de demande d autorisation Enregistrement «fin» : Position Description Valorisation dans l enregistrement «fin» 1 Code enregistrement FIN Description des journaux de reporting Copyright Natixis Paiements page 16/38

17 Format des champs Le format n est donné qu à titre indicatif et peut être amené à changer (notamment pour les champs de type enum). Position Libellé Format 1 ENTETE a9 2 MERCHANT_ID n PAYMENT_DATE n8 4 TRANSACTION_ID an6 5 OPERATION_SEQUENCE n..3 6 OPERATION_NAME an..32 (enum) 7 OPERATION_AMOUNT n OPERATION_CURRENCY n3 9 OPERATION_DATE n8 10 OPERATION_TIME n6 11 OPERATION_ORIGIN ans RESPONSE_CODE n2 13 NEW_STATUS ans..32 (enum) 14 RETURN_CONTEXT ans Exemple de fichier V3 TITRE;DWHLAJO;090205_12:19:00;TABLE_V3; ENTETE;MERCHANT_ID;PAYMENT_DATE;TRANSACTION_ID;OPERATION_SEQUENCE;OPERATION_NA ME;OPERATION_AMOUNT;OPERATION_CURRENCY;OPERATION_DATE;OPERATION_TIME;OPERATIO N_ORIGIN;RESPONSE_CODE;NEW_STATUS; OPERATION; ; ;998174;1;DUPLICATE;9900;978;090205;121327;test;00;TO_CAPTURE; OPERATION; ; ;998174;2;CANCEL;9900;978;090205;121400;test;00;CANCELLED; FIN; Légende : Enregistrement «Titre» Enregistrement «Entête» Enregistrements «détails» (2 enregistrements dans l exemple ci-dessous) Enregistrement «Fin» Description des journaux de reporting Copyright Natixis Paiements page 17/38

18 Structure du fichier V4 Enregistrement «titre» : L enregistrement «Titre» fournit les caractéristiques du fichier. Sa valorisation est la suivante : Position Description Valorisation dans l enregistrement «titre» 1 Code enregistrement = TITRE 2 Nom de la boutique 3 Date et heure de l envoi (AA/MM/JJ_hh :mm :ss) 4 Format et version TABLE_V4 Entête et Détail de l enregistrement L enregistrement «Entête» récapitule les libellés des données transmises. Les enregistrements «détails» contiennent, pour chaque opération, la valorisation des données précédemment listées dans l enregistrement «entête». Position Libellé de la donnée 1 ENTETE 2 MERCHANT_COUNTRY 3 MERCHANT_ID 4 PAYMENT_DATE 5 TRANSACTION_ID 6 OPERATION_SEQUENCE 7 OPERATION_NAME Description de la donnée (=colonne si tableau) Code enregistrement Pays du commerçant Identifiant du commerçant Date de paiement (AAAAMMJJ) identifiant de la transaction Numéro de l opération Typologie de l action effectuée. Valorisation dans l enregistrement «détail» Valorisation possible OPERATION FR 0 + SIRET FRANCE Signification Invocation de la check URL lors du paiement, MERCHANT_BO_CHECK_URL modification, duplication depuis le BO Invocation de la check URL BATCH_AUTO_CHECK_URL lors de l'autorisation via les tâches Invocation de la check URL RECURRENCE_CHECK_URL lors du paiement par récurrences Invocation de la check lors du FILE_CHECK_URL paiement par fichier d'identifiants Invocation de la check URL PAYMENT_CHECK_URL, lors du paiement Invocation manuelle de la MANUAL_CHECK_URL check URL depuis le BO sur une transaction existante ADVICE Forçage de transaction Autorisation d une transaction (dans le cas où l autorisation AUTHOR n est pas effectuée en temps réel) CANCEL CREDIT_CAPTURE Annulation de la transaction Remise en banque d un remboursement Description des journaux de reporting Copyright Natixis Paiements page 18/38

19 Position Libellé de la donnée Description de la donnée (=colonne si tableau) montant de l opération OPERATION_AMOUNT exprimé dans la plus petite unité 8 de la devise devise de OPERATION_CURRENCY 9 l opération 10 OPERATION_DATE date de l opération heure de OPERATION_TIME 11 l opération ID de l utilisateur OPERATION_ORIGIN ayant réalisé 12 l action. 13 RESPONSE_CODE 14 BANK_RESPONSE_CODE Code réponse à la demande d autorisation Code réponse de la banque émettrice à la demande d autorisation Valorisation dans l enregistrement «détail» Valorisation possible DEBIT_CAPTURE DUPLICATE CREDIT EXPIRED MODIFICATION TRANSACTION VALIDATE WAIT REACTIVATION Signification Remise en banque d un paiement Duplication de transaction Remboursement d une transaction Expiration d une transaction Modification d une transaction Saisie d un paiement manuel Validation d une transaction Mise en attente d une transaction Réactivation de transaction Valorisé à «Batch» s il s agit d une traitement automatisé 00 Autorisation acceptée 02 Le commerçant doit contacter la banque du porteur 05 Autorisation refusée 30 Erreur de format. 34 Suspicion de fraude Nombre de tentatives de 75 saisie du numéro de carte dépassé. Erreur technique lors du 96 paiement Valorisation pour les cartes CB, VISA, MASTERCARD transaction approuvée ou traitée avec succès contacter l'émetteur de la carte 03 accepteur invalide 04 conserver la carte 05 ne pas honorer 07 conserver la carte, conditions spéciales 08 approuver après identification 12 transaction invalide 13 montant invalide 14 numéro de porteur invalide 15 Emetteur de carte inconnu 17 Annulation client Répéter la transaction ultérieurement Réponse erronée (erreur dans le domaine serveur Mise à jour de fichier non supportée Description des journaux de reporting Copyright Natixis Paiements page 19/38

20 Position Libellé de la donnée Description de la donnée (=colonne si tableau) Valorisation dans l enregistrement «détail» Valorisation possible Signification Impossible de localiser 25 l enregistrement dans le fichier Enregistrement dupliqué, 26 ancien enregistrement remplacé 27 Erreur en «edit» sur champ de mise à jour fichier 28 Accès interdit au fichier 29 Mise à jour de fichier impossible 30 erreur de format 31 identifiant de l'organisme acquéreur inconnu 33 date de validité de la carte dépassée 34 suspicion de fraude 38 Nombre d essais code confidentiel dépassé 41 carte perdue 43 carte volée 51 provision insuffisante ou crédit dépassé 54 date de validité de la carte dépassée 55 Code confidentiel erroné 56 carte absente du fichier 57 transaction non permise à ce porteur 58 transaction interdite au terminal 59 suspicion de fraude 60 l'accepteur de la carte doit contacter l'acquéreur 61 montant de retrait hors limite 63 règles de sécurité non respectées 68 réponse non parvenue ou reçue trop tard 75 Nombre d essai code confidentiel dépassé Porteur déjà en opposition, 76 ancien enregistrement conservé 90 arrêt momentané du système 91 émetteur de carte inaccessible 94 Transaction dupliquée 96 mauvais fonctionnement du système 97 échéance de la temporisation de surveillance globale 98 serveur indisponible routage réseau demandé à nouveau 99 incident domaine initiateur Valorisation pour les cartes AMEX 00 Transaction approuvée ou traitée avec succès 02 Dépassement de plafond 04 Conserver la carte 05 Ne pas honorer Description des journaux de reporting Copyright Natixis Paiements page 20/38