Prélèvement SEPA SDD - Ponctuel (One Off) PayZen 2.3

Transcription

1 Prélèvement SEPA SDD - Ponctuel (One Off) PayZen 2.3 Version du document 2.0

2 Système de gestion de la documentation Historique du document Version Auteur Date 2.0 Lyra Network 17/03/ Lyra Network 03/09/2014 Commentaire Passage de la plateforme de paiement en version 2.3 Remboursement par virement Réception des journaux d'impayés par ou ftp Personnalisation de l' de pré-notification de prélèvement sepa dans le centre de notification Version initiale Prélèvement SEPA SDD - Ponctuel One Off 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.

3 Sommaire 1. CONTACTER L'ASSISTANCE TECHNIQUE SEPA : PAYER PAR PRELEVEMENT Identifier les informations obligatoires sur le mandat Distinguer les mandats en fonction du type de prélèvement Identifier les délais encadrant l'émission d'un prélèvement SEPA Visualiser la cinématique du prélèvement SEPA Identifier le canal de transmission des ordres de prélèvement SEPA à la banque PRÉSENTATION DU MOYEN DE PAIEMENT Prérequis Stocker et archiver les mandats signés Visualiser le déroulement d'un prélèvement unique sur la page de paiement Visualiser les transactions SEPA dans le Back Office Visualiser le détail des mandats dans le Back Office Notifier le débiteur Un pour la pré-notification Un pour notifier le paiement...14 Personnaliser l' de pré-notification Importer les mandats de prélèvement SEPA ÉTABLIR LE DIALOGUE AVEC LA PLATEFORME DE PAIEMENT Définir l'url de la page de paiement...16 S'identifier lors des échanges Choisir le mode Test ou Production Gérer le dialogue vers le site marchand Gérer la sécurité Gérer la sécurité au moyen de la signature...20 Conserver le certificat de production Gérer les données sensibles...21 Utiliser des i-frame Paramétrer les notifications Configurer la notification à la fin du paiement Configurer la notification en cas d'abandon/annulation Paramétrer les délais encadrant l'émission d'un prélèvement SEPA...24 Délai de remise Délai de pré-notification GÉNÉRER UN FORMULAIRE DE PAIEMENT Effectuer une demande de prélèvement unique UTILISER DES FONCTIONS COMPLÉMENTAIRES Pré remplir le formulaire de saisie sur la page de paiement Modifier la date d'échéance d'un prélèvement...29 Personnaliser la RUM Gérer le retour vers le site marchand Définir les URL de retour Activer le retour automatique vers le site marchand... 33

4 7. CALCULER LA SIGNATURE ENVOYER LA DEMANDE DE PAIEMENT Rediriger l'acheteur vers la page de paiement Gérer les erreurs ANALYSER LE RÉSULTAT DU PAIEMENT Récupérer les données retournées dans la réponse Récupérer les données lors de la notification instantanée Récupérer les données lors du retour à la boutique Calculer la signature Comparer les signatures Analyser la nature de la notification Analyser le résultat du paiement Récupérer les détails du mandat OPÉRATIONS SUR LES TRANSACTIONS Identifier les opérations indisponibles Identifier les opérations autorisées ACTIVER LA BOUTIQUE EN MODE PRODUCTION Passer en mode production Basculer votre site marchand en production...43 Réaliser un premier paiement en production Regénérer le certificat de production DICTIONNAIRE DE DONNÉES... 45

5 1. CONTACTER L'ASSISTANCE TECHNIQUE En cas de problème de connexion au Back Office, utilisez le lien «mot de passe oublié ou compte bloqué». Pour toute question technique ou demande d'assistance, nos services sont disponibles du lundi au vendredi, de 9h à 18h : par téléphone au : depuis l'étranger, par support@payzen.eu Pour faciliter le traitement de vos demandes, il vous sera demandé de communiquer votre identifiant de boutique (numéro à 8 chiffres). Cette information est disponible dans l' d'inscription de votre boutique, ou dans le Back Office (menu Paramétrage > Boutique > Configuration). Droit de propriété intellectuelle - 5 / 109

6 2. SEPA : PAYER PAR PRELEVEMENT Le prélèvement SEPA (Single Euro Payments Area ou espace unique de paiement en euro) également appelé SEPA Direct Debit (SDD), est un projet européen qui vise à créer des moyens de paiement en euro (virements, prélèvements et cartes bancaires) communs à l'ensemble des pays européens. Ce moyen de paiement est proposé par un créancier (marchand) à un débiteur (acheteur) afin de régler automatiquement des factures récurrentes ou ponctuelles. Le prélèvement SEPA s appuie sur un formulaire unique : le «Mandat de prélèvement SEPA» Identifier les informations obligatoires sur le mandat Le mandat de prélèvement SEPA contient les éléments suivants : Le type de prélèvement du mandat: ponctuel ou récurrent. La RUM (Référence Unique de Mandat) : c'est une référence unique qui identifie chaque mandat signé. Les coordonnées (nom) du débiteur. Le BIC (Business Identifier Code) et l'iban (International Bank Account Number) du débiteur : ces codes sont destinés à identifier de manière fiable le destinataire d'un virement ou d'un prélèvement. Les coordonnées (nom et adresse) du créancier. L'ICS (Identifiant Créancier SEPA) du créancier : c'est un code unique identifiant chaque société habilitée à prélever. L'ICS est attribué par la Banque de France par l'intermédiaire d'un établissement bancaire. La date de signature du mandat. La signature du débiteur autorisé par sa banque à faire fonctionner le compte sur lequel s'opèrent les prélèvements Distinguer les mandats en fonction du type de prélèvement On distingue deux types de mandats : Ponctuel Le mandat signé vaut pour un prélèvement unique. Il expire après cet unique prélèvement. Récurrent Le mandat signé vaut pour une série de prélèvements. Il devient caduc à l'issue de 36 mois sans paiement ou après un prélèvement "FNAL". Le mandat de prélèvement SEPA est révocable à tout moment par le débiteur ou le créancier. Le prélèvement SEPA fonctionne selon des «séquences». Le tableau ci-dessous liste les séquences possibles pour le prélèvement et le code associé en fonction du type de mandat. Type de mandat Séquence possible pour le prélèvement Code Ponctuel ONE OFF : prélèvement unique, non suivi par d autres prélèvements au titre du même mandat. OOFF Récurrent FIRST : 1er prélèvement d une série. FRST RECURRENT : prélèvements consécutifs au 1er d une série. RCUR FINAL : dernier prélèvement d une série. FNAL Tableau 1 : Séquences possibles en fonction du type de prélèvement Droit de propriété intellectuelle - 6 / 109

7 Selon la séquence, les délais encadrant les présentations interbancaires d un prélèvement SEPA ne sont pas les mêmes Identifier les délais encadrant l'émission d'un prélèvement SEPA Une pré-notification doit être envoyée au moins 14 jours calendaires avant la date d'échéance du prélèvement. Avec accord bilatéral, ce délai peut être réduit mais la prénotification doit obligatoirement précéder l'envoi en banque des ordres de prélèvement soit : 5 jours ouvrés bancaires avant la date d échéance pour un prélèvement SEPA ponctuel (One-Off OOFF) ou le premier d une série (First - FRST). 2 jours ouvrés bancaires avant la date d échéance à partir de la deuxième opération de prélèvement SEPA dans une série (Récurrent RCUR ou Final FNAL). Exemple de prélèvement SEPA soumis en décembre 2013: Avec ses jours fériés, le mois de décembre est le parfait exemple pour illustrer les délais encadrant l encaissement par prélèvement SEPA. Un prélèvement SEPA au 1er janvier (date d échéance) doit être présenté à la banque du débiteur : Au plus tôt le 18 décembre, c'est-à-dire 14 jours calendaires avant la date d'échéance. Au plus tard le 23 décembre, c'est-à-dire 5 jours ouvrés bancaires avant la date d'échéance pour un prélèvement ponctuel. Au plus tard le 30 décembre, c'est-à-dire 2 jours ouvrés bancaires avant la date d'échéance pour un prélèvement récurrent. Le 1er janvier est un jour férié. Cette date d échéance ne correspond pas à un jour ouvré bancaire. L ordre de prélèvement SEPA est exécuté le jour ouvré bancaire suivant, c est-à-dire le 2 janvier. Droit de propriété intellectuelle - 7 / 109

8 2.4. Visualiser la cinématique du prélèvement SEPA Ci-dessous la cinématique générale des échanges pour un prélèvement SEPA : Image 1 : Cinématique générale des échanges pour un prélèvement SEPA Etapes 1, 2 et 3 Echanges de documents Le prélèvement SEPA repose sur un mandat de prélèvement SEPA à signer par le débiteur et matérialisant son consentement vis-à-vis du créancier pour prélever toutes les sommes dues sur son compte. Chaque mandat est identifié par une Référence Unique de Mandat qui permet d identifier le contrat pour lequel les prélèvements SEPA sont dus. Pour chaque prélèvement SEPA, le créancier doit envoyer au débiteur une pré-notification, 14 jours calendaires avant la date d échéance du prélèvement, pour l avertir du prélèvement. Etapes 4 et 5 Envois de messages Le créancier fait parvenir à sa banque l ordre de prélèvement SEPA. Cette dernière va se mettre en relation avec la banque du débiteur afin de procéder au prélèvement SEPA interbancaire. Etapes 6, 7 et 5 Transferts de fonds Le compte bancaire du débiteur va être débité au profit du compte bancaire du créancier. Droit de propriété intellectuelle - 8 / 109

9 2.5. Identifier le canal de transmission des ordres de prélèvement SEPA à la banque Les ordres de prélèvement SEPA sont transmis à la banque, le plus souvent via le protocole EBICS (Electronic Banking Internet Communication Standard : protocole de télétransmission standard). On distingue deux protocoles EBICS : EBICS T avec «signature disjointe» : le créancier doit confirmer les ordres de prélèvements sur sa banque en ligne ou par fax (selon le contrat avec sa banque). C'est ce protocole de communication qui est utilisé par la plateforme de paiement. EBICS TS avec «signature jointe» : Avant que les ordres de prélèvements ne soient transférés à la banque, le créancier les signe numériquement avec un certificat délivré par une autorité de certification. Veuillez-vous rapprocher de votre banque pour connaître les modalités de télétransmission des ordres de prélèvement SEPA. Droit de propriété intellectuelle - 9 / 109

10 3. PRÉSENTATION DU MOYEN DE PAIEMENT Ce document présente l encaissement par prélèvement unique via la signature d un mandat ponctuel. Par la suite, la RUM (Référence Unique de Mandat) est appelée : Identifiant acheteur sur la page de paiement, Identifiant de compte client dans le Back Office Prérequis Pour utiliser ce moyen de paiement, le marchand doit : Souscrire à un contrat d'abonnement télétransmission EBICS T avec sa banque ou demander la création d'un nouvel utilisateur EBICS T sur sa connexion EBICS. Souscrire à l'option Paiement par prélèvement SEPA SDD auprès de PayZen Communiquer son ICS à PayZen. Pour recevoir les journaux d'impayés par ou ftp, le marchand doit : Souscrire aux flux d'impayés auprès de sa banque. Souscrire à l'option Rapprochement bancaire auprès de PayZen. Remarque : Si le créancier connait le numéro de téléphone portable du débiteur (numéro de téléphone enregistré lors d'une inscription), ce numéro sera pré-renseigné sur la page de paiement. Le débiteur ne pourra, en aucun cas, le modifier lors de la signature du mandat. Seul le titulaire du GSM ayant enregistré ce numéro de téléphone lors de son inscription recevra par SMS ce code d'accès à usage unique. Si le créancier ne connait pas le numéro de téléphone portable du débiteur, le débiteur sera invité à renseigner son numéro de téléphone sur la page de paiement. Il recevra par SMS un code qu'il communiquera au moment de valider le mandat de prélèvement SEPA. Stocker et archiver les mandats signés La signature du mandat s'effectue : en cochant En cochant cette case, vous certifiez avoir lu et compris les informations présentées dans ce mandat et y apposer votre signature. Le mandat est sauvegardé localement. Le créancier (marchand) en assure le stockage et l'achivage. en renseignant le code de sécurité reçu par SMS Le mandat bénéficie d'un archivage à valeur légale dans le coffre-fort électronique de la Caisse des Dépôts et Contestations. En cas de contestation, cette signature vous garantit que le mandat n'a subi aucune transformation par un tiers. En effet la Caisse des Dépôts et Contestations fournit un faisceaux de preuves qui ne peut être contesté ou objecté. Vous pouvez cependant, si vous le souhaitez, désactiver la signature d'un mandat par SMS. Pour cela, veuillez contacter le service client de votre plateforme de paiement. Droit de propriété intellectuelle - 10 / 109

11 3.2. Visualiser le déroulement d'un prélèvement unique sur la page de paiement Le mandat ponctuel vaut pour un prélèvement unique et ne donnera pas lieu à une série de prélèvements. Il sera impossible d effectuer d autres prélèvements avec le même mandat. Voici le déroulement de l encaissement par prélèvement: 1. Le débiteur sélectionne le moyen de paiement Prélèvement SEPA. Image 2 : Choix du moyen de paiement 2. Il clique sur Valider. 3. La page suivante récapitule les informations de la transaction (Identifiant du marchand, Numéro de transaction et Montant). Le débiteur doit renseigner les champs Nom, Prénom, , IBAN et BIC. Image 3 : Saisie des coordonnées bancaires du débiteur 4. Saisissez ou contrôlez le numéro de téléphone portable. Image 4 : Saisie du numéro de téléphone portable du débiteur 5. Une fois les données renseignées, le débiteur clique sur Valider. 6. Plusieurs vérifications sont effectuées afin de contrôler la validité de l'iban et du BIC renseignés. Si les données sont erronées, le message Le compte bancaire indiqué n'est pas compatible avec ce moyen de paiement est affiché. Si le contrôle de l'iban a abouti avec succès, le mandat de prélèvement SEPA contenant l'ensemble des informations requises est affiché. Le débiteur doit vérifier l'exactitude de ces informations. Droit de propriété intellectuelle - 11 / 109

12 Image 5 : Validation du mandat 7. Pour pouvoir valider ce mandat, le débiteur doit obligatoirement cocher la mention En cochant cette case, vous certifiez avoir lu et compris les informations présentées dans ce mandat et y apposer votre signature et renseigner le code de sécurité reçu par SMS. Image 6 : Saisie du code reçu par SMS 8. Le débiteur clique sur Valider. 9. Un récapitulatif est ensuite affiché. Image 7 : Récapitulatif d'un prélèvement SEPA SDD 3.3. Visualiser les transactions SEPA dans le Back Office Les transactions sont visibles dans le Back Office depuis le menu Gestion > Transactions. Tant que la date d'échéance n'est pas atteinte, les transactions sont présentes dans l'onglet Paiements en cours. Une fois la présentation interbancaire réalisée, les transactions sont présentes dans l'onglet Paiements remis Image 8 : Onglet Paiements en cours Droit de propriété intellectuelle - 12 / 109

13 Double cliquez sur une transaction SEPA pour en obtenir le détail. Image 9 : Détail d'une transaction SEPA en cours 3.4. Visualiser le détail des mandats dans le Back Office Les informations des mandats complétés et signés sont accessibles depuis le Back Office. Vous pouvez en afficher le détail à partir du menu Gestion > Abonnements > onglet Comptes client > sélectionnez un Identifiant comptes client. Vous pouvez également recevoir un mandat par (clic droit sur l identifiant compte client > Recevoir le mandat par ). Ce dernier est uniquement traduit dans les langues de l union européenne : Français, Allemand, Anglais, Espagnol, Italien, Néerlandais, Polonais, Portugais et Suédois. Droit de propriété intellectuelle - 13 / 109

14 3.5. Notifier le débiteur Deux s sont envoyés au débiteur par la plateforme de paiement : Un pour la pré-notification La plateforme de paiement notifie le débiteur par 14 jours ouvrés maximum avant la date d échéance. Si un accord est établit entre les deux parties, ce délai peut être réduit (voir chapitre Identifier les délais encadrant l émission d un prélèvement SEPA). Modèle de pré-notification : Remarque : Le modèle de l' pour la pré-notification peut être personnalisé (voir chapitre Personnaliser l' de pré-notification). Un pour notifier le paiement La plateforme de paiement notifie le débiteur par pour lui confirmer l enregistrement de la demande de son prélèvement. Modèle d pour cette notification : Droit de propriété intellectuelle - 14 / 109

15 Personnaliser l' de pré-notification Le modèle de l' pour la pré-notification peut être personnalisé. Pour cela : 1. Connectez-vous à votre Back Office ( 2. Cliquez sur Paramétrage > Règles de notifications > onglet envoyé à l'acheteur. 3. Effectuez un clic droit sur le libellé Mail de pré-notification de prélèvement SEPA à destination de l'acheteur. 4. Sélectionnez Gérer la règle dans le menu contextuel. 5. Dans Paramétrage acheteur, sélectionnez la langue de l' puis cliquez sur Restaurer des valeurs de texte par défaut afin de personnaliser le contenu de l' . Vous pouvez prévisualiser l' de pré-notification avant de sauvegarder vos modifications en cliquant sur le bouton Prévisualiser l' situé en bas de la boîte de dialogue Gestion de la règle. 6. Cliquez sur Sauvegarder Importer les mandats de prélèvement SEPA Il est possible d importer des mandats de prélèvement SEPA. Pour plus d informations, veuillez contacter le support technique. Droit de propriété intellectuelle - 15 / 109

16 4. ÉTABLIR LE DIALOGUE AVEC LA PLATEFORME DE PAIEMENT Le dialogue entre le site marchand et la plateforme de paiement s effectue par un échange de données. Pour créer un paiement, ces données sont envoyées au moyen d'un formulaire HTML via le navigateur de l acheteur. A la fin du paiement, le résultat est transmis au site marchand de deux manières: automatiquement au moyen de notifications appelées URL de notification instantanée (également appelée IPN pour Instant Payment Notification), voir chapitre Paramétrer les notifications, par le navigateur lorsque l acheteur clique sur le bouton pour revenir au site marchand, voir chapitre Gérer le retour vers le site marchand. Pour assurer la sécurité des échanges, les données sont signées au moyen d un certificat connu uniquement du marchand et de la plateforme de paiement Définir l'url de la page de paiement Le site marchand communique avec la plateforme de paiement en redirigeant l acheteur vers la page : S'identifier lors des échanges Pour dialoguer avec la plateforme de paiement, le marchand a besoin de deux informations : L identifiant boutique: permet d'identifier le site marchand durant les échanges. Sa valeur est transmise dans le champ vads_site_id. Le certificat : permet de calculer la signature numérique transmise dans le champ signature. Pour récupérer ces valeurs : 1. Connectez-vous à votre Back Office : 2. Cliquez sur Paramétrage > Boutique. 3. Sélectionnez l onglet Certificats. Image 10 : Visualiser l identifiant de la boutique et le certificat Deux types de certificat sont mis à disposition : Le certificat de test qui permet de générer la signature d un formulaire en mode test. Le certificat de production qui permet de générer la signature d'un formulaire en mode production. Droit de propriété intellectuelle - 16 / 109

17 4.3. Choisir le mode Test ou Production Le choix du mode TEST ou PRODUCTION s'effectue en utilisant le champ vads_ctx_mode (Voir chapitre Générer un formulaire de paiement). Le mode TEST permet de réaliser des paiements de test. Il est toujours disponible, même après la génération du certificat de production. Si vous créez un nouveau site marchand (ou disposez d un environnement de recette), vous pourrez effectuer vos tests sans impacter le site actuellement en production. Les transactions de TEST sont visibles dans le Back Office depuis le menu Gestion > Transactions de Test Image 11 : Visualiser les transactions de test Le mode PRODUCTION n est disponible qu une fois le certificat de production généré (voir chapitre Activer la boutique en mode PRODUCTION ). Il permet de réaliser des paiements réels. Les transactions de PRODUCTION sont visibles dans le Back Office depuis le menu Gestion > Transactions. Image 12 : Visualiser les transactions de production Droit de propriété intellectuelle - 17 / 109

18 4.4. Gérer le dialogue vers le site marchand La gestion du dialogue vers le site marchand est réalisée grâce à deux types d URL : Url de notification instantanée, également appelée IPN (Instant Payment Notification), Url de retour vers le site marchand. Url de notification instantanée - IPN (Instant Payment Notification) La plateforme de paiement notifie automatiquement au site marchand le résultat du paiement. Les données sont envoyées en mode POST. La plateforme est capable de contacter le site marchand quel que soit le protocole utilisé (http ou https). Pour traiter ces notifications, le marchand doit créer une page sur son site qui : analyse les données reçues en mode POST, s assure de l intégrité des informations reçues en calculant la signature, vérifie qu il ne s agit pas d un doublon de notification (renvoi de la notification depuis le Back Office par exemple), déclenche la mise à jour de sa base de données (état de la commande, stock, etc ), envoie des s à l acheteur (facture, suivi de commande, etc ). Le temps de traitement influe directement sur le délai d affichage de la page de résumé du paiement. Plus le traitement est long, plus l affichage est retardé. Pour recevoir les notifications, le marchand doit paramétrer les règles de notifications depuis son Back Office (voir chapitre Paramétrer les notifications). En cas de problème de communication vers le site marchand, la plateforme de paiement envoie un à l administrateur de la boutique, précisant la raison de l échec (erreur http, etc. ) ainsi que la procédure à suivre pour renvoyer la notification depuis le Back Office. Url de retour vers le site marchand Le marchand peut paramétrer dans le Back Office les URL de retour "par défaut" depuis le menu Paramétrage > Boutique > onglet Configuration) : Image 13 : Spécification des URL de retour Il peut configurer une URL de retour à la boutique différente en fonction du mode. Par défaut, l'acheteur est redirigé vers l'url de retour, et ce, quel que soit le résultat du paiement. Droit de propriété intellectuelle - 18 / 109

19 Si toutefois aucune URL n est configurée à ce niveau, alors la redirection utilisera l'url principale de la boutique (paramètre URL défini dans l'encadré Détails de la boutique). Le marchand a la possibilité de surcharger cette configuration dans son formulaire de paiement (voir chapitre Définir les URL de retour). Remarque : Le statut de la règle "URL de notification à la fin du paiement" (IPN) est affiché dans cet écran. Si cette dernière est non paramétrée, veillez à la renseigner (voir chapitre Paramétrer les notifications). Droit de propriété intellectuelle - 19 / 109

20 4.5. Gérer la sécurité Plusieurs moyens sont mis en place afin d assurer la sécurité des transactions de paiement en ligne. Gérer la sécurité au moyen de la signature L intégrité des informations échangées est garantie par un échange de signatures numériques entre la plateforme de paiement et le site marchand. Le dialogue entre la plateforme de paiement et le site marchand s effectue par soumission de formulaires HTML. Un formulaire contient une liste de champs spécifiques (voir Générer un formulaire de paiement) utilisés pour calculer sa signature numérique (voir chapitre Calculer la signature). Le résultat de ce calcul doit être envoyé dans le champ signature. Nous utilisons la fonction de hachage «SHA-1» pour chiffrer la signature. SHA-1 est disponible dans la plupart des langages utilisés dans le développement d applications Web. En fonction du language choisi, vous aurez peut être à coder vous-même les fonctions de hachage SHA-1 (comme en ASP par exemple). Pour vous aider, voici le résultat du SHA-1 du caractère " a " : SHA1( " a ") = 86f7e437faa5a7fce15d1ddcb9eaeaea377667b8 Modélisation des mécanismes de sécurité : Image 14 : Diagramme mécanisme de sécurité 1. Le site marchand récolte les données du formulaire et calcule la signature. 2. Le site marchand soumet le formulaire à la plateforme. 3. La plateforme réceptionne les données du formulaire et calcule la signature. 4. La plateforme compare la signature calculée avec la signature transmise par le site marchand. Droit de propriété intellectuelle - 20 / 109

21 5. Si les signatures diffèrent, la demande de paiement est rejetée. Sinon, la plateforme procède au paiement. 6. La plateforme réceptionne les données du résultat et calcule la signature de la réponse. 7. En fonction du paramétrage de la boutique (voir chapitre Paramétrer les notifications), la plateforme soumet le résultat du paiement au site marchand. 8. Le site marchand réceptionne les données et calcule la signature. Il compare la signature calculée avec la signature transmise par la plateforme. 9. Si les signatures diffèrent, le marchand analyse l origine de l erreur (erreur dans le calcul, tentative de fraude etc...) Sinon, le site marchand procède à la mise à jour de sa base de données (état du stock, état de la commande etc ). Conserver le certificat de production Dès le premier paiement réalisé avec une carte réelle, le certificat de production est masqué pour des raisons de sécurité. Nous vous conseillons fortement de conserver ce certificat en lieu sûr (fichier chiffré, base de données etc ). En cas de perte, le marchand aura la possibilité d en générer un nouveau depuis son Back Office. Pour rappel, le certificat de production est visible dans le Back Office depuis le menu Paramétrage > Boutique > onglet Certificats. Gérer les données sensibles Des règles strictes régissent les transactions de paiement en ligne (Certification PCI-DSS). En tant que marchand, vous devez vous assurer de ne jamais retranscrire en clair des données qui pourraient s apparenter à un numéro de carte bancaire. Votre formulaire serait rejeté (code Sensitive data detected). Evitez notamment les numéros de commandes de longueur comprise entre 13 et 16 caractères numériques et commençant par 3, 4 ou 5. Utiliser des i-frame Une i-frame (in line frame) est utilisée pour afficher une page web dans une autre page web. Par défaut et pour des raisons de sécurité, l utilisation des i-frames pour afficher la page de paiement n'est pas activée. Cependant, il est possible d'activer son utilisation. Veuillez contacter l'interlocuteur de votre plateforme de paiement si vous souhaitez utiliser une i-frame. Exemples de codes : <FRAMESET> <FRAME SRC=" </FRAMESET> <iframe src=" Droit de propriété intellectuelle - 21 / 109

22 4.6. Paramétrer les notifications Le Back Office permet de gérer les événements qui génèreront un appel vers le site marchand et de configurer l URL de la page à contacter. Configurer la notification à la fin du paiement Pour paramétrer cette notification : 1. Connectez-vous à : 2. Allez dans le menu : Paramétrage > Règles de notifications. 3. Effectuez un clic droit sur la ligne URL de notification à la fin du paiement. 4. Sélectionnez Gérer la règle. 5. Renseignez l URL de votre page dans les champs URL à appeler en mode TEST et URL à appeler en mode PRODUCTION. 6. Renseignez le champ Adresse(s) (s) à avertir en cas d échec. 7. Configurez le Rejeu automatique en cas d échec. Cette option permet de renvoyer automatiquement la notification vers le site marchand en cas d'échec, et ce, jusqu'à 4 fois. Pour plus d'informations, reportez-vous au chapitre Activer le rejeu automatique du guide d'implémentation du formulaire disponible sur notre site documentaire : 8. Sauvegardez vos modifications. Si la plateforme n'arrive pas à joindre l'url de votre page, alors un est envoyé à l'adresse spécifiée à l'étape 6. Il contient : Le code HTTP de l'erreur rencontrée Des éléments d'analyse en fonction de l'erreur Ses conséquences La procédure à suivre depuis le Back Office pour renvoyer la requête vers l URL définie à l étape 5 Configurer la notification en cas d'abandon/annulation La plateforme de paiement peut notifier systématiquement le site marchand: En cas d abandon/annulation de la part de l acheteur, via le bouton Annuler et retourner à la boutique. Lorsque l'acheteur n'a pas terminé son paiement avant l'expiration de sa session de paiement. La durée maximale d'une session de paiement est de 10 minutes. Pour paramétrer cette notification: 1. Connectez-vous à : 2. Allez dans le menu : Paramétrage > Règles de notifications. 3. Effectuez un clic droit sur la ligne URL de notification sur annulation. Droit de propriété intellectuelle - 22 / 109

23 4. Sélectionnez Gérer la règle. 5. Renseignez l URL de votre page dans les champs URL à appeler en mode TEST et URL à appeler en mode PRODUCTION. 6. Renseignez Adresses(s) (s) à avertir en cas d échec. 7. Pour spécifier plusieurs adresses séparez-les par un point-virgule. 8. Configurez le Rejeu automatique en cas d échec. Cette option permet de renvoyer automatiquement la notification vers le site marchand en cas d'échec, et ce, jusqu'à 4 fois. Pour plus d'informations, reportez-vous au chapitre Activer le rejeu automatique du guide d'implémentation du formulaire disponible sur notre site documentaire support/integration-payzen/. 9. Sauvegardez vos modifications. Si la plateforme n arrive pas à joindre l URL de votre page, alors un est envoyé à l adresse spécifiée à l'étape 6. Il contient : le code HTTP de l erreur rencontrée, des éléments d analyse en fonction de l erreur, la procédure à suivre depuis le Back Office pour renvoyer la requête vers l URL définie à l étape 5. Droit de propriété intellectuelle - 23 / 109

24 4.7. Paramétrer les délais encadrant l'émission d'un prélèvement SEPA Vous pouvez modifier: Le délai entre la soumission du formulaire et la présentation interbancaire (délai de remise), Le délai de pré-notification à destination du débiteur (acheteur). Délai de remise Modifiable depuis le Back Office (Menu Paramétrage > Boutique > Configuration). Par défaut, le délai de remise est configuré à 0 jour. Il peut être modifié via le formulaire de paiement (voir chapitre Modifier la date d'un prélèvement ). Toute modification de la date de remise entrainera la modification de : la date de présentation, la date de pré notification. Délai de pré-notification Modifiable uniquement sur demande auprès du service client. Il est par défaut de 14 jours calendaires. Sa valeur peut être comprise entre 14 et : 6 jours au minimum pour un prélèvement ponctuel ou pour le premier d'une série, 3 jours au minimum pour un prélèvement récurrent. Droit de propriété intellectuelle - 24 / 109

25 5. GÉNÉRER UN FORMULAIRE DE PAIEMENT Pour générer une demande de paiement, vous devez construire un formulaire html comme suit : <form method="post" action=" <input type="hidden" name="parametre1" value="valeur1" /> <input type="hidden" name="parametre2" value="valeur2" /> <input type="hidden" name="parametre3" value="valeur3" /> <input type="hidden" name="signature" value="signature"/> <input type="submit" name="payer" value="payer"/> </form> Il contient: Les éléments techniques suivants : Les balises <form> et </form> qui permettent de créer un formulaire HTML. L attribut method="post" qui spécifie la méthode utilisée pour envoyer les données. L attribut action=" qui spécifie où envoyer les données du formulaire. Les données du formulaire : L identifiant de la boutique, Les caractéristiques du paiement en fonction du cas d utilisation, Les informations complémentaires en fonction de vos besoins, La signature qui assure l'intégrité du formulaire (voir chapitre Calculer la signature). Ces données sont ajoutées au formulaire en utilisant la balise <input>: <input type="hidden" name="parametre1" value="valeur1" /> Pour valoriser les attributs name et value, référez-vous au chapitre Dictionnaire de données. Toutes les données du formulaire doivent être encodées en UTF-8. Les caractères spéciaux (accents, ponctuation etc ) seront ainsi correctement interprétés par la plateforme de paiement. Dans le cas contraire, le calcul de signature sera erroné et le formulaire sera rejeté. Le bouton Payer qui va permettre l envoi des données : <input type="submit" name="payer" value="payer"/> Droit de propriété intellectuelle - 25 / 109

26 5.1. Effectuer une demande de prélèvement unique Dans le cas d'un encaissement par prélèvement unique, l'acheteur autorise le marchand à prélever la totalité de son achat en une seule fois. 1. Utilisez l'ensemble des champs présents dans le tableau ci-après pour construire votre formulaire de paiement. Nom du champ Valeur vads_site_id Identifiant de la boutique Ex : vads_ctx_mode Mode de fonctionnement TEST ou PRODUCTION vads_trans_id Numéro de la transaction Ex : vads_trans_date Date et heure UTC du formulaire de paiement Ex : vads_amount Montant du paiement (dans sa plus petite unité Ex : 3000 pour 30 monétaire) vads_currency Code de la devise euro : vads_action_mode Mode d acquisition des données bancaires. INTERACTIVE vads_page_action Action à réaliser PAYMENT vads_version Version du protocole d échange V2 vads_payment_config Type de paiement SINGLE vads_capture_delay Délai avant remise en banque 0 vads_cust_ Adresse de l acheteur Ex : payzen@gmail.com Tableau 2 : Liste des champs - Paiement par prélèvement SDD One Off 2. Valorisez le champ vads_page_action à PAYMENT dans le cas d un encaissement par prélèvement ponctuel. 3. Valorisez le champ vads_payment_config à SINGLE. Le paiement par prélèvement SDD n est pas compatible avec le mode MULTI. 4. Valorisez le champ vads_action_mode à INTERACTIVE. Le prélèvement SDD n est pas compatible avec le mode SILENT. 5. Valorisez le champ vads_currency à 978 (code de la devise euro). Seule la devise euro est acceptée pour ce moyen de paiement. 6. Valorisez le champ vads_capture_delay à 0 pour que le transfert de fonds soit effectué au maximum 14 jours calendaires après l achat. 7. Ajoutez les champs optionnels en fonction de vos besoins (voir chapitre Utiliser des fonctions complémentaires). 8. Calculez la valeur du champ signature en utilisant l'ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir chapitre Calculer la signature). Droit de propriété intellectuelle - 26 / 109

27 Exemple de formulaire: <form method="post" action=" <input type="hidden" name="vads_action_mode" value="interactive" /> <input type="hidden" name="vads_amount" value="2990" /> <input type="hidden" name="vads_capture_delay" value="0" /> <input type="hidden" name="vads_ctx_mode" value="test" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_cust_country" value="fr" /> <input type="hidden" name="vads_cust_ " /> <input type="hidden" name="vads_cust_first_name" value="paul" /> <input type="hidden" name="vads_cust_last_name" value="juve" /> <input type="hidden" name="vads_cust_title" value="m." /> <input type="hidden" name="vads_page_action" value="payment" /> <input type="hidden" name="vads_payment_config" value="single" /> <input type="hidden" name="vads_site_id" value=" " /> <input type="hidden" name="vads_trans_date" value=" " /> <input type="hidden" name="vads_trans_id" value="362812" /> <input type="hidden" name="vads_validation_mode" value="0" /> <input type="hidden" name="vads_version" value="v2" /> <input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/><input type="submit" name="payer" value="payer"/></form> Droit de propriété intellectuelle - 27 / 109

28 6. UTILISER DES FONCTIONS COMPLÉMENTAIRES Pour obtenir un formulaire personnalisé et adapté à vos besoins, vous pouvez utiliser des fonctions complémentaires parmi la liste ci-dessous : Pré-remplir le formulaire de saisie Personnaliser la RUM Modifier la date d'échéance d'un prélèvement Gérer les URL de retour vers le site marchand Activer le retour automatique vers le site marchand à la fin du paiement D autres fonctionnalités sont présentées dans le guide d implémentation du formulaire de paiement. Elles vous permettront de construire facilement votre formulaire de paiement Pré remplir le formulaire de saisie sur la page de paiement Pour alléger la saisie des informations vous pouvez pré-remplir les champs suivants : Nom du champ vads_cust_title Permet de définir la civilité de l acheteur. Valeurs attendues (respectez la casse): M. Mme Mlle vads_cust_last_name Permet de définir le nom de l acheteur. vads_cust_first_name Permet de définir le prénom de l acheteur. vads_cust_ Permet de définir l adresse de l acheteur. vads_payment_cards Permet de présélectionner le moyen de paiement sur le site marchand. Valeur attendue: SDD Tableau 3 : Liste des champs - Pré remplissage du formulaire de paiement Droit de propriété intellectuelle - 28 / 109

29 6.2. Modifier la date d'échéance d'un prélèvement Par défaut, dans le Back Office: Le délai de remise est configuré à 0 jour, Le délai de pré notification est configuré à 14 jours. Avec cette configuration : La date de pré notification sera à J, La date d échéance sera à J+14, La date de présentation sera à J+6 (5 jours ouvrés avant la date d échéance). Donc au minimum la date de présentation sera toujours à J+6. Cette configuration peut être modifiée directement dans le Back Office. Elle peut être aussi surchargée dans le formulaire en valorisant le paramètre vads_capture_delay avec une valeur supérieure à 6. Exemple : Valeur du délai de capture Date de pré-notification Date de présentation Date d'échéance De 0 à 6 J J+6 J+14 7 J+1 J+7 J J+15 J+15 J+23 Tableau 4 : Exemples de valorisations du champ vads_capture_delay Attention, en modifiant cette valeur, vous influencez directement la date de présentation et la date de pré notification Personnaliser la RUM Par défaut la RUM est générée par la plateforme de paiement. Cependant, le marchand peut générer et transmettre la valeur en respectant les conditions suivantes: La valeur doit être transmise dans le champ vads_identifier. Le marchand doit s assurer de l unicité de la RUM. Toute demande de prélèvement ponctuel ou récurrent réalisée sur une RUM existante engendrera une erreur et l affichage d un message d incident technique. Longueur : jusqu à 35 caractères. Caractères autorisés : abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ /-?:().,'+ L espace n est pas un caractère autorisé. Droit de propriété intellectuelle - 29 / 109

30 6.4. Gérer le retour vers le site marchand A la fin du paiement, l acheteur a la possibilité de revenir sur le site marchand sur une page appelée URL de retour. A ne pas confondre avec l URL de notification instantanée (également appelée IPN) (voir chapitre Gérer le dialogue vers le site marchand). Définir les URL de retour Dans le formulaire de paiement, le marchand peut surcharger la configuration du Back Office. Pour cela il peut: Utiliser 4 URL différentes en fonction du résultat du paiement: Paiement accepté. Paiement refusé. Paiement abandonné. Paiement en erreur. Utiliser une seule URL quel que soit le résultat du paiement. Définir les URL de retour en fonction du résultat du paiement 1. Utilisez l ensemble des champs nécessaires à votre cas d utilisation (voir chapitre Générer un formulaire de paiement) pour construire votre formulaire de paiement. 2. Utilisez les champs facultatifs présentés dans le tableau ci-dessous pour concevoir le formulaire de paiement adapté à vos besoins. Si aucune URL n est valorisée dans le formulaire, la valeur configurée dans le Back Office sera prise en compte. Nom du champ Descrition vads_url_success URL où sera redirigé l acheteur, en cas de succès du paiement, après appui sur "retourner à la boutique". vads_url_refused URL où sera redirigé l acheteur, en cas de refus du paiement, après appui sur "retourner à la boutique". vads_url_cancel URL où sera redirigé l acheteur après appui sur "annuler et retourner à la boutique" avant d'avoir procédé au paiement. vads_url_error URL où sera redirigé l acheteur en cas d'erreur de traitement par la plateforme de paiement. 3. Calculez la valeur du champ signature en utilisant l ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir chapitre Calculer la signature). Exemple de formulaire de paiement avec définition d'url de retour en fonction du résultat du paiement: <form method="post" action=" <input type="hidden" name="vads_action_mode" value="interactive" /> <input type="hidden" name="vads_amount" value="3000" /> <input type="hidden" name="vads_capture_delay" value="0" /> <input type="hidden" name="vads_ctx_mode" value="test" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_page_action" value="payment" /> <input type="hidden" name="vads_payment_config" value="single" /> <input type="hidden" name="vads_site_id" value=" " /> <input type="hidden" name="vads_trans_date" value=" " /> <input type="hidden" name="vads_trans_id" value="239848" /> <input type="hidden" name="vads_url_cancel" value=" /> <input type="hidden" name="vads_url_error" value=" /> <input type="hidden" name="vads_url_refused" value=" /> <input type="hidden" name="vads_url_success" value=" /> <input type="hidden" name="vads_version" value="v2" /> Droit de propriété intellectuelle - 30 / 109

31 <input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/> <input type="submit" name="payer" value="payer"/> </form> Définir une URL de retour unique quelque soit le résultat du paiement 1. Utilisez l ensemble des champs nécessaires à votre cas d utilisation (voir chapitre Générer un formulaire de paiement) pour construire votre formulaire de paiement. 2. Utilisez le champ facultatif vads_url_return pour définir l url de redirection à la fin du paiement. Si aucune URL n est valorisée dans le formulaire, la valeur configurée dans le Back Office sera prise en compte. 3. Calculez la valeur du champ signature en utilisant l ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir chapitre Calculer la signature). Exemple de formulaire de paiement avec une URL de retour unique quelque soit le résultat du paiement: <form method="post" action=" <input type="hidden" name="vads_action_mode" value="interactive" /> <input type="hidden" name="vads_amount" value="3000" /> <input type="hidden" name="vads_capture_delay" value="0" /> <input type="hidden" name="vads_ctx_mode" value="test" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_page_action" value="payment" /> <input type="hidden" name="vads_payment_config" value="single" /> <input type="hidden" name="vads_site_id" value=" " /> <input type="hidden" name="vads_trans_date" value=" " /> <input type="hidden" name="vads_trans_id" value="239848" /> <input type="hidden" name="vads_url_return" value=" /> <input type="hidden" name="vads_version" value="v2" /> <input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/> <input type="submit" name="payer" value="payer"/> </form> Droit de propriété intellectuelle - 31 / 109

32 Définir la méthode de réception des données Par défaut, le site marchand ne reçoit aucun paramètre. Pour récupérer des informations sur la page de retour (tracking, statistiques, personnalisation des messages à destination de l acheteur, etc..), le marchand peut surcharger cette configuration dans son formulaire de paiement. 1. Utilisez l ensemble des champs nécessaires à votre cas d utilisation (voir chapitre Générer un formulaire de paiement) pour construire votre formulaire de paiement. 2. Utilisez le champ facultatif vads_return_mode pour indiquer la méthode de transmission des données vers le site marchand. Valeur Absent, vide ou NONE Aucune donnée n'est passée à l URL de retour. GET Les données sont transmises dans l URL de la page de retour POST Les données sont transmises à la page de retour sous la forme d un formulaire HTTP POST. La méthode GET permet d'éviter l affichage d un message d'avertissement lorsque le retour se fait sur un environnement non sécurisé (http). 3. Calculez la valeur du champ signature en utilisant l ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir chapitre Calculer la signature). Exemple de formulaire de paiement avec définition du mode de transmission des données: <form method="post" action=" <input type="hidden" name="vads_action_mode" value="interactive" /> <input type="hidden" name="vads_amount" value="3000" /> <input type="hidden" name="vads_capture_delay" value="0" /> <input type="hidden" name="vads_ctx_mode" value="test" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_page_action" value="payment" /> <input type="hidden" name="vads_payment_config" value="single" /> <input type="hidden" name="vads_return_mode" value="get" /> <input type="hidden" name="vads_site_id" value=" " /> <input type="hidden" name="vads_trans_date" value=" " /> <input type="hidden" name="vads_trans_id" value="239848" /> <input type="hidden" name="vads_url_return" value=" /> <input type="hidden" name="vads_version" value="v2" /> <input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/> <input type="submit" name="payer" value="payer"/> </form> Droit de propriété intellectuelle - 32 / 109

33 6.5. Activer le retour automatique vers le site marchand Le marchand peut indiquer dans son formulaire s il souhaite rediriger automatiquement l acheteur vers le site marchand à la fin du paiement. Si vous utilisez un code de tracking (Google AnalyticsTM ou autre) sur votre site, vous devez implémenter cette fonctionnalité. 1. Utilisez l ensemble des champs nécessaires à votre cas d utilisation (voir chapitre Générer un formulaire de paiement) pour construire votre formulaire de paiement. 2. Utilisez les champs facultatifs ci-dessous en fonction de vos besoins. Nom du champ vads_redirect_success_timeout Définit le délai d attente avant redirection après un paiement réussi. Ce délai est exprimé en seconde et doit être compris entre 0 et 300 secondes. vads_redirect_success_message Définit le message d attente avant la redirection après un paiement réussi. vads_redirect_error_timeout Définit le délai d attente avant redirection après un paiement refusé. Ce délai est exprimé en seconde et doit être compris entre 0 et 300 secondes. vads_redirect_error_message Définit le message d attente avant la redirection après un paiement refusé. Tableau 5 : Liste des champs facultatifs disponibles. 3. Valorisez le champ vads_return_mode à GET. 4. Calculez la valeur du champ signature en utilisant l ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir chapitre Calculer la signature ). Exemple de formulaire de paiement: <form method="post" action=" <input type="hidden" name="vads_action_mode" value="interactive" /> <input type="hidden" name="vads_amount" value="3000" /> <input type="hidden" name="vads_capture_delay" value="0" /> <input type="hidden" name="vads_ctx_mode" value="test" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_page_action" value="payment" /> <input type="hidden" name="vads_payment_config" value="single" /> <input type="hidden" name="vads_redirect_error_message" value="vous allez être redirigé vers votre site marchand" /> <input type="hidden" name="vads_redirect_error_timeout" value="0" /> <input type="hidden" name="vads_redirect_success_message" value="vous allez être redirigé vers votre site marchand" /> <input type="hidden" name="vads_redirect_success_timeout" value="0" /> <input type="hidden" name="vads_return_mode" value="get" /> <input type="hidden" name="vads_site_id" value=" " /> <input type="hidden" name="vads_trans_date" value=" " /> <input type="hidden" name="vads_trans_id" value="239848" /> <input type="hidden" name="vads_url_return" value=" /> <input type="hidden" name="vads_version" value="v2" /> <input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/> <input type="submit" name="payer" value="payer"/> </form> Droit de propriété intellectuelle - 33 / 109

34 7. CALCULER LA SIGNATURE Afin de pouvoir calculer la signature vous devez être en possession de la totalité des champs dont le nom commence par vads_ et du certificat (la valeur du certificat permet de calculer la signature numérique.). Pour calculer la signature : 1. Triez les champs dont le nom commence par vads_ par ordre alphabétique. 2. Assurez-vous que tous les champs soient encodés en UTF Concaténez les valeurs de ces champs en les séparant avec le caractère "+". 4. Concaténez le résultat avec le certificat de test ou de production, en les séparant avec le caractère "+". 5. Appliquez l algorithme SHA-1 pour obtenir la valeur de la signature. Exemple de paramètres envoyés à la plateforme de paiement: <form method="post" action=" <input type="hidden" name="vads_action_mode" value="interactive" /> <input type="hidden" name="vads_amount" value="1524" /> <input type="hidden" name="vads_ctx_mode" value="test" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_page_action" value="payment" /> <input type="hidden" name="vads_payment_config" value="single" /> <input type="hidden" name="vads_site_id" value=" " /> <input type="hidden" name="vads_trans_date" value=" " /> <input type="hidden" name="vads_trans_id" value="654321" /> <input type="hidden" name="vads_version" value="v2" /> <input type="hidden" name="signature" value="606b369759fac4f c803c73676cbe470ff"/> <input type="submit" name="payer" value="payer"/> </form> Cet exemple de formulaire s'analyse de la manière suivante: 1. On trie par ordre alphabétique les champs dont le nom commence par vads_ : vads_action_mode vads_amount vads_ctx_mode vads_currency vads_page_action vads_payment_config vads_site_id vads_trans_date vads_trans_id vads_version 2. On concatène la valeur de ces champs avec le caractère "+" : INTERACTIVE+1524+TEST+978+PAYMENT+SINGLE V2 3. On ajoute la valeur du certificat de test à la fin de la chaîne en la séparant par le caractère "+"). Dans cet exemple, le certificat de Test est : INTERACTIVE+1524+TEST+978++PAYMENT+SINGLE V On applique l algorithme SHA-1 à la chaîne obtenue. Le résultat à transmettre dans le champ signature est : 606b369759fac4f c803c73676cbe470ff. Droit de propriété intellectuelle - 34 / 109