Guide d implémentation - Echange de fichiers - Paiement par identifiant Fichier des cartes arrivant à expiration Version 1.1
Rédaction, Vérification, Approbation Rédaction Vérification Approbation Nom Date/Visa Nom Date/Visa Nom Date/Visa Lyra-Network 16/09/2010 Historique du document Version Auteur Date Commentaires 1.0 Lyra-Network 16/09/2010 Version initiale. 1.1 Lyra-Network 21/09/2010 Introduction des 2 types de fichiers Confidentialité Toutes les informations contenues dans ce document sont considérées comme confidentielles. L utilisation de celles-ci en dehors du cadre de cette consultation ou la divulgation à des personnes extérieures est soumise à l approbation préalable de Lyra Network.
SOMMAIRE 1 PRINCIPE GENERAL... 4 1.1 PRESENTATION DU SERVICE... 4 1.2 PRINCIPE DE FONCTIONNEMENT... 4 2 DETAILS DES FICHIERS... 5 2.1 TYPES DE FICHIER GENERES... 5 2.2 MODALITES DE GENERATION COMMUNES AUX DEUX TYPES DE FICHIERS... 5 2.3 DETAILS DU FICHIER DES CARTES ARRIVANT A ECHEANCE DE L ENSEIGNE... 6 2.3.1 Modalités de génération spécifiques... 6 2.3.2 Enregistrement d entête... 6 2.3.3 Enregistrement de détail... 7 2.3.4 Enregistrement de fin... 7 2.4 DETAILS DU FICHIER DES CARTES ARRIVANT A ECHEANCE D UNE BOUTIQUE... 8 2.4.1 Modalités de génération spécifiques... 8 2.4.2 Enregistrement d entête... 8 2.4.3 Enregistrement de détail... 9 2.4.4 Enregistrement de fin... 9 3 ASSISTANCE TECHNIQUE... 10
1 PRINCIPE GENERAL 1.1 Présentation du service Le service de fichier des cartes arrivant à échéance du module de gestion des paiements par identifiant permet aux sites marchands de consulter les identifiants dont les cartes bancaires associées vont bientôt arriver à expiration. Cela permet notamment aux commerçants de mettre en place des mécanismes d alerte pour les clients concernés. Contrairement aux autres traitements par fichiers, les fichiers de cartes arrivant à échéance ne nécessitent pas de fichier en entrée de la part du commerçant. Les fichiers sont générés automatiquement par la plateforme. 1.2 Principe de fonctionnement Les fichiers seront mis à disposition sur un compte FTP. Dans les transactions FTP, la plateforme de paiement agit comme le serveur, et le site marchand comme le client. L accès au répertoire dans lequel seront stockés les fichiers est protégé par un couple nom d utilisateur/mot de passe qui vous a été préalablement communiqué à l ouverture du service. De la même manière que les autres fichiers générés par la plateforme, les fichiers de cartes arrivant à expiration seront supprimés tous les 45 jours. Lyra Network- 4/10
2 DETAILS DES FICHIERS 2.1 Types de fichier générés La plateforme génère 2 types de fichiers : - un fichier commun à l enseigne qui regroupe les identifiants non résiliés associés à des cartes arrivant à échéance, qu ils aient des abonnements ou non ; - un fichier par boutique qui regroupe les identifiants auxquels est rattaché au moins un abonnement, pour cette boutique, et associés à des cartes arrivant à échéance. 2.2 Modalités de génération communes aux deux types de fichiers Les fichiers de cartes arrivant à échéance, quels que soient leur type, sont générés tous les 1 er de chaque mois à 4h00. Ils contiennent tous les identifiants (et éventuelles s) qui sont associés à une carte bancaire arrivant à échéance, c'est-à-dire dont la date d expiration est proche. Une carte bancaire est considérée comme proche de l échéance si la différence entre la fin de validité de la carte et la date du jour est inférieure ou égale à X mois. X représente un nombre configurable par le commerçant sur son outil de gestion de caisse, dans le menu Paramétrage > Paramètres Abonnement. La valeur par défaut est de 2 mois. Les fichiers seront constitués d une série d enregistrements. On appelle «enregistrement» une liste de paramètres séparés par le caractère «;», et terminée par un retour chariot. On a donc un enregistrement par ligne. Ce type de format est communément appelé «CSV» (pour Comma Separated Values), et est notamment reconnu par MS Excel ou Open Office Calc. Les fichiers auront la structure suivante : - Un enregistrement d entête spécifiant des informations sur la tâche. - Un nombre variable d enregistrements contenant les informations sur les identifiants et éventuelles s proches de l échéance. - Un enregistrement de fin, permettant de s assurer de la cohérence du fichier transmis. Les paragraphes suivants décrivent le format des divers enregistrements, selon le type de fichier. Pour les champs applicables, la colonne «Equivalence» correspond à la codification du champ telle qu utilisée dans l interface vers la page de paiement. Lyra Network- 5/10
2.3 Détails du fichier des cartes arrivant à échéance de l enseigne 2.3.1 Modalités de génération spécifiques Le fichier sera nommé de la manière suivante : <SSAAMM>.EXP_CARDS.ENS.<z> Où : - <SSAAMM> représente la date de génération du fichier (par exemple 201009). - <z> prend soit la valeur «T» pour un fichier en mode TEST, soit la valeur «P» pour un fichier en mode PRODUCTION. 2.3.2 Enregistrement d entête 01 Code enregistrement n2 Valorisé à 00 02 Type de fichier Valorisé à EXP_CARDS 03 Environnement a1 Valorisé à T ou P vads_ctx_mode 04 Date de création n8 La date de démarrage de la tâche 05 Heure de création n6 L heure de démarrage de la tâche Lyra Network- 6/10
2.3.3 Enregistrement de détail 01 Code enregistrement n2 Valorisé à 02 02 Identifiant de carte ans..50 vads_identifier 03 Nom du porteur de carte an..127 vads_cust_name 04 L email du porteur de carte an..127 vads_cust_email 05 La date d expiration de la carte n8 Au format SSAAMMJJ 06 Le nombre de Le détail des s se s non n..6 trouve dans le fichier de la résiliées associées à boutique correspondante cet identifiant 2.3.4 Enregistrement de fin 01 Code enregistrement n2 Valorisé à 01 02 Nombre total d enregistrements détail n..6 transmis 03 Date de fin de traitement n8 Au format SSAAMMJJ 04 Heure de fin de traitement n6 Au format HHMMSS Lyra Network- 7/10
2.4 Détails du fichier des cartes arrivant à échéance d une boutique 2.4.1 Modalités de génération spécifiques Le fichier sera nommé de la manière suivante : <SSAAMM>.<siteID>.EXP_CARDS.PDV.<z> Où : - <SSAAMM> représente la date de génération du fichier. - <siteid> représente le numéro de boutique qui vous a été attribué - <z> prend soit la valeur «T» pour un fichier en mode TEST, soit la valeur «P» pour un fichier en mode PRODUCTION. 2.4.2 Enregistrement d entête 01 Code enregistrement n2 Valorisé à 00 02 Type de fichier Valorisé à EXP_CARDS 03 Identifiant de boutique n8 Identifiant fourni à sa création vads_site_id 04 Environnement a1 Valorisé à T ou P vads_ctx_mode 05 Date de création n8 La date de démarrage de la tâche 06 Heure de création n6 L heure de démarrage de la tâche Lyra Network- 8/10
2.4.3 Enregistrement de détail 01 Code enregistrement n2 Valorisé à 02 02 Identifiant de carte ans..50 vads_identifier 03 Nom du porteur de carte an..127 vads_cust_name 04 L email du porteur de carte an..127 vads_cust_email 05 La date d expiration de la carte n8 Au format SSAAMMJJ 06 Identifiant unique de la ans..50 vads_subscription Indique le numéro de la 07 courant. Par Compteur de n3 exemple, 1/3 pour la première des 3 s de l identifiant. 08 Description de la vads_sub_desc 09 10 11 12 Date d effet de la Montant fixe de la Montant initial de la Nombre d occurrences initiales n8 n..12 n..12 n..3 vads_sub_effect_d ate vads_sub_amount vads_sub_init_amo unt vads_sub_init_amo unt_number 2.4.4 Enregistrement de fin 01 Code enregistrement n2 Valorisé à 01 02 Nombre total d enregistrements détail n..6 transmis Nombre d identifiants Le nombre total d identifiant 03 dont les cartes sont n..6 dont la carte arrive à proches de l expiration échéance, pour la boutique 04 Date de fin de traitement n8 Au format SSAAMMJJ 05 Heure de fin de traitement n6 Au format HHMMSS Lyra Network- 9/10
3 ASSISTANCE TECHNIQUE Pour tout problème d accès à l outil de gestion de caisse, il convient d utiliser le lien «Mot de passe oublié ou compte bloqué?» disponible sur la page de connexion de l outil de gestion de caisse. Lyra Network- 10/10