Guide utilisateur du prélèvement bancaire SEPA Version 1.A Payline Monext Propriétaire Page 1 / 20
Historique des évolutions Le tableau ci-dessous liste les dernières modifications effectuées sur ce document. EVOLUTIONS Version Date Modifications 1.A 15/01/2014 Version initiale Monext Propriétaire Page 2 / 20
Table des matières 1. Introduction... 4 1.1. Objet du document... 4 1.2. Public visé... 4 1.3. Liste des documents de référence... 4 1.4. Contact... 4 2. Abréviations et glossaire... 5 3. Introduction... 6 3.1. Qu'est-ce que le prélèvement?... 6 3.2. Comment proposer le prélèvement à mes clients... 7 3.2.1. Pré requis... 7 3.2.2. Intégration du prélèvement en homologation... 7 3.2.3. Intégration du prélèvement en production... 7 3.3. Quelles sont les fonctionnalités disponibles... 7 3.4. Cinématique de paiement... 8 4. Utiliser le prélèvement sur votre boutique... 9 4.1. Réaliser un prélèvement par pages de paiement... 9 4.1.1. Appel au web service DoWebPayment... 9 4.2. Les pages de paiement vues par le consommateur... 12 5. Gérer vos transactions... 15 5.1. Configurer l ordre d affichage du moyen de paiement... 15 5.2. Analyser le résultat d un prélèvement... 16 5.3. Gestion et reporting des transactions... 16 5.3.1. Suivi des transactions depuis le backoffice Payline... 16 5.3.2. Fichier reporting... 17 6. Annexe Liste des codes retours... 18 6.1. Codes erreur transaction... 18 6.2. Codes résultat signature... 20 6.3. Codes résultat collecte... 20 Monext Propriétaire Page 3 / 20
1. Introduction 1.1. Objet du document Ce document est un guide d intégration du prélèvement bancaire SEPA dans la plateforme de paiement Payline. 1.2. Public visé Ce document est destiné aux commerçants et intégrateurs qui souhaitent utiliser le prélèvement bancaire dans la solution de paiement Payline. 1.3. Liste des documents de référence La documentation suivante est disponible sur notre site internet section documentation : www.payline.com ou sur simple demande auprès de notre service support : support@payline.com 1.4. Contact Vous avez besoin d aide, de conseil ou vous souhaitez simplement nous poser une question. Contactez l Assistance Payline par : Email : support@payline.com Pour toute question liée à la mise en place de la solution Payline, vous pouvez joindre notre assistance technique par mail support@payline.com, du lundi au vendredi de 09h00 à 18h00. Monext Propriétaire Page 4 / 20
2. Abréviations et glossaire SEPA SDD ICS RUM Single Euro Payments Area Initiative européenne visant à harmoniser les moyens de paiement en euro (virements, prélèvements, carte bancaire)entre les pays membres de la zone SEPA (Union Européenne + 5 pays de l AELE) SEPA Direct Débit Nom officiel du prélèvement dans la terminologie SEPA Identifiant de Créancier SEPA (SEPA Creditor Identifier en anglais) Identifie un créancier de façon unique au sein de la zone SEPA Référence Unique de Mandat (Unique Mandate Reference en anglais) La RUM est attribuée par le créancier. Le couple (RUM, ICS) identifie de façon unique un mandat. Monext Propriétaire Page 5 / 20
3. Introduction 3.1. Qu'est-ce que le prélèvement bancaire? Les pages de paiement Payline ont été développées pour que les consommateurs puissent effectuer leurs paiements dans un environnement ergonomique et convivial, avec une sécurité optimale. Les données de paiement (les coordonnées bancaires) sont transmises à Payline à l aide de protocoles sécurisés. Ces données sont uniquement échangées entre Payline et les serveurs SLIMPAY, solution de paiement spécialisée sur le prélèvement SEPA, partenaire de Payline. SLIMPAY Permet l acquisition et le traitement d ordres de paiement pour le compte des entreprises et notamment des marchands en ligne. Réalise la signature électronique du mandat de prélèvement SEPA : l acheteur donne par ce biais l autorisation de prélèver son compte à un marchand donné, sans quitter le tunnel d achat. Plus aucun document n est envoyé par voie postale au marchand ou à la banque de l acheteur. Effectue également l exécution des ordres de prélèvement pour le compte des marchands. PAYLINE Gère le moyen de paiement «prélèvement bancaire SDD» au travers de ses pages web de paiements, de son API webservice, de son interface fichier et de son backoffice marchand. Permet de réaliser un paiement «1 clic» par prélèvement bancaire sans avoir à redemander une autorisation au consommateur. Assure la réconciliation technique et financière des paiements CB et SDD. Monext Propriétaire Page 6 / 20
3.2. Comment proposer le paiement par compte bancaire à mes clients 3.2.1. Pré requis Vous devez au préalable avoir souscrit un contrat auprès de Slimpay. Slimpay : info@slimpay.com 01 47 70 15 34 3.2.2. Intégration du prélèvement en homologation Pour terminer votre intégration du prélèvement en pré production, il vous faut informer le support Payline de la fin de votre qualification et de votre souhait de passage en production en écrivant à cette adresse : support@payline.com Notre équipe vous transmettra un PV de recette pour valider la fin de votre qualification. 3.2.3. Intégration du paiement par compte bancaire en production A réception du PV de recette signé et complété par vos soins, le support Payline réalise la création du moyen de paiement de prélèvement sur l environnement de production Payline. Vous recevrez un email vous avertissant de la mise en place du moyen de paiement en production Payline. 3.3. Quelles sont les fonctionnalités disponibles Lors du premier paiement, et après signature électronique du mandat, il est possible de réaliser Un paiement par prélèvement SDD avec un premier paiement par carte bancaire Un paiement par prélèvement SDD uniquement, en mode immédiat ou différé Pour les paiements mensuels, les ordres doivent être transmis à Payline par API WS ou par fichier avec le montant à prélever et la RUM concernée Modification d un mandat Edition d un mandat Lutte contre la fraude Monext Propriétaire Page 7 / 20
3.4. Cinématique de paiement Un parcours client simple et efficace! Le consommateur renseigne ses données de paiement (BIC IBAN seul ou avec n CB) Payline contacte Slimpay pour une signature du e-mandat Payline archive la transaction et enregistre la RUM La RUM est générée par Payline en associant le champ walletid et CardIndex Monext Propriétaire Page 8 / 20
4. Utiliser le prélèvement sur votre boutique Ce chapitre explique comment intégrer rapidement le prélèvement via Payline dans votre boutique. Nous vous recommandons de réaliser chaque étape afin de garantir une bonne intégration de prélèvement dans Payline. 4.1. Réaliser un prélèvement par pages de paiement 4.1.1. Appel au web service DoWebPayment L affichage des pages de paiement Payline nécessite simplement de contacter le service web «dowebpayment». Ce web service retourne à votre serveur l url sur laquelle vous devez rediriger votre client afin qu il réalise son paiement. Cas 1 : Signature du mandat Un nouveau code action (500) est ajouté à ceux existants pour la création d une transaction de signature de mandat. Les autres données sont les données minimum transmises à Slimpay lors de l envoi de la requête de signature du mandat. Nom du champ Obligatoire Format Commentaire payment.action O N(3) La valeur est 500 payment.mode O AN La valeur est CPT buyer.lastname O AN Nom du porteur.street1.cityname.zipcode.country buyer.walletid O AN O AN Adresse de facturation (première ligne O AN Ville de facturation O N Code postal de facturation O AN Pays de facturation Identifiant du portefeuille. Permet la construction de la RUM Monext Propriétaire Page 9 / 20
Cas 2 : Prélèvement simple Le code action est uniquement 101 avec un mode CPT car lors d un prélèvement simple deux actions seront mises en place : La signature d un mandat (le contrat sélectionné devra être de type SDD) La demande d un premier prélèvement immédiat à Slimpay directement complété dans la trame d envoi. Nom du champ Obligatoire Format Commentaire payment.action O N(3) La valeur est 101 payment.mode O AN La valeur est CPT buyer.lastname O AN Nom du porteur.street1.cityname.zipcode.country buyer.walletid O AN O AN Adresse de facturation (première ligne O AN Ville de facturation O N Code postal de facturation O AN Pays de facturation Identifiant du portefeuille. Permet la construction de la RUM Monext Propriétaire Page 10 / 20
Cas 3 : Prélèvement + 1er paiement CB Le code action est 100 ou 101 avec un mode CPT ou DIFF car lors d un prélèvement simple + 1er paiement CB deux actions seront mises en place : La signature d un mandat (le contrat sélectionné devra être de type SDD) La demande d un premier paiement par carte bancaire. Il s agit d une demande de paiement CB classique. Le code action et le mode s applique à la carte bancaire Nom du champ Obligatoire Format Commentaire payment.action O N(3) La valeur est 100 ou 101 payment.mode O AN La valeur est CPT ou DIFF Payment.differedA ctiondate N DATE buyer.lastname O AN Nom du porteur.street1.cityname.zipcode.country buyer.walletid O AN Date du paiement CB si le mode est DIFF et le code action est 100 O AN Adresse de facturation (première ligne O AN Ville de facturation O N Code postal de facturation O AN Pays de facturation Identifiant du portefeuille. Permet la construction de la RUM Enfin, dans le cas où vous souhaitez afficher uniquement les pages de paiement par prélèvement, vous devez renseigner le champ «contractnumber» par le numéro de contrat que vous avez renseigné lors de la configuration du moyen de paiement. Monext Propriétaire Page 11 / 20
4.2. Les pages de paiement vues par le consommateur Sur votre site d e-commerce, votre client clique sur le bouton «payer» pour procéder au paiement de sa commande. Votre site contacte Payline pour effectuer une transaction. Payline renvoi un jeton de session et l URL à utiliser pour rediriger votre client vers les pages web Payline. Dans le cas de l interface direct, le choix du moyen de paiement sera effectué sur le site marchand. Cette page n apparait pas. Etape 1 Le client choisi le paiement Prélèvement bancaire et valide. Monext Propriétaire Page 12 / 20
Etape 2 Le client est redirigé vers la page de saisie des données. Il identifie son compte bancaire par son IBAN, ou le format local usuel. Le service SlimPay vérifiera automatiquement l accessibilité de ce compte. Un dispositif de prévention de l usurpation d identité est mis en œuvre. Paiement CB + Prélèvement Prélèvement Monext Propriétaire Page 13 / 20
Etape 3 En signant électroniquement un mandat, le client autorise le débit direct de son compte de la somme convenue, ou d une série de paiements. La signature est réalisée par un code SMS à usage unique. A la fin de cette étape, il reçoit par email le mandat signé. Les débits sont ensuite opérés par SlimPay au nom du commerçant. Ils sont notifiés sur le relevé bancaire. Le client dispose de modalités pour contester des paiements erronés ou non autorisés auprès de sa banque. Monext Propriétaire Page 14 / 20
5. Gérer vos transactions Ce chapitre explique comment intégrer rapidement le prélèvement via Payline dans votre boutique. Nous vous recommandons de réaliser chaque étape afin de garantir une bonne intégration dans Payline 5.1. Configurer l ordre d affichage du moyen de paiement Il est possible de configurer l ordre d affichage des moyens de paiements sur la page lors de l affichage des choix sur la page Web de paiements Cette configuration est faite a partir du centre d administration Payline, dans le menu Configuration, cliquez sur Vos points de vente. Dans le pavé Personnalisation du point de vente, cliquez sur le lien Définir l ordre des moyens de paiements. La liste des moyens de paiements s affiche et permet de faire monter ou descendre le moyen de paiement pour obtenir l ordre souhaité Monext Propriétaire Page 15 / 20
5.2. Analyser le résultat d un prélèvement Payline vous informe du résultat d un paiement via le code retour des messages getwebtransactiondetails et gettransactiondetails. Lorsque le paiement est accepté, Payline renvoie le code retour à la valeur «00000». Pour un paiement refusé, le code varie en fonction du motif de refus Les codes spécifiques au moyen de paiement sont listés en Annexe. 5.3. Gestion et reporting des transactions 5.3.1. Suivi des transactions depuis le backoffice Payline Sur le centre d administration vous avez la possibilité de visualiser la transaction effectuée avec le moyen de paiement Détail de la transaction : Monext Propriétaire Page 16 / 20
5.3.2. Fichier reporting Payline intègre les fichiers de reporting, ce qui permet le suivie dans le centre d administration des prélèvements et de pouvoir retrouver ces informations dans le fichier de reporting consolidé. Ce fichier peut être : Soit généré manuellement via le centre d administration. Dans le menu Transactions de paiement, cliquez sur Exporter vos transactions. Soit généré en automatique quotidiennement en envoyé par un flux sécurisé. Monext Propriétaire Page 17 / 20
6. Annexe Liste des codes retours 6.1. Codes erreur transaction Code Payline Libellé court Libellé long 00000 Transaction approved Transaction acceptée 34000 Transaction pending Transaction SDD pending 34001 Transaction refused Requested function not available 34002 Transaction refused Erreur interne, statut indisponible 34100 Transaction refused Erreur interne SlimPay, système indisponible momentanément. 34101 Transaction refused Les données de la transaction sont incomplètes. 34102 Transaction refused Le type de requête est vide. 34103 Transaction refused L'authentification du marchand a échoué. 34104 Transaction refused Le site marchand est inconnu. 34105 Transaction refused Le blob contient un timestamp incohérent. 34106 Transaction refused Le code d'activation pour la mise en production est incorrect. 34107 Transaction refused Les données d'initialisation sont incorrectes. 34108 Transaction refused La référence client est invalide. 34109 Transaction refused L'authentification du TPE a échoué. 34111 Transaction refused Le type de paiement est invalide. 34113 Transaction refused Le décodage du blob a échoué. 34116 Transaction refused La notification du marchand a échoué. 34118 Transaction refused Le type de paiement n a pas été fourni 34119 Transaction refused Le client a annulé ou abandonne la transaction 34120 Transaction refused La session a expire. 34121 Transaction refused Le paramètre clienttype est incorrect. 34122 Transaction refused Le paramètre title est incorrect. 34123 Transaction refused Le paramètre firstname est incorrect. 34124 Transaction refused Le paramètre lastname est incorrect. 34125 Transaction refused Le paramètre email est incorrect. 34127 Transaction refused Le paramètre phonenumber est incorrect. 34128 Transaction refused Le paramètre postalcodeinv est incorrect. 34129 Transaction refused Le paramètre countryinv est incorrect. 34133 Transaction refused Le paramètre bic est incorrect. Monext Propriétaire Page 18 / 20
34134 Transaction refused Le paramètre iban est incorrect. 34135 Transaction refused Le paramètre RUM est incorrect. 34136 Transaction refused Le paramètre debitamount est incorrect. 34137 Transaction refused Le paramètre executiondate est incorrect. 34138 Transaction refused Le paramètre label est > 140 caractères. 34139 Transaction refused Le paramètre cardoperationtype est incorrect. 34140 Transaction refused Le paramètre cardamount est incorrect. 34141 Transaction refused Le paramètre clientreference est incorrect. 34142 Transaction refused Le paramètre companyname est incorrect. 34143 Transaction refused Le paramètre organizationid est incorrect. 34144 Transaction refused Le paramètre line1 de l'adresse est incorrect. 34145 Transaction refused Le paramètre line2 de l'adresse est incorrect. 34146 Transaction refused Le paramètre country de l'adresse est incorrect. 34147 Transaction refused Le paramètre transactionid est incorrect. 34148 Transaction refused Compte en dehors de la zone SEPA 34149 Transaction refused Requête avec le même transactionid (doublon) 34150 Transaction refused Le paramètre receivepaymentamount est incorrect 34151 Transaction refused Le paramètre receivepaymentdeadline est incorrect 34152 Transaction refused Le paramètre receivepaymentid est incorrect 34153 Transaction refused La référence de commande (receivepaymentid) a déjà été reçue (doublon) 34154 Transaction refused Il n existe pas de mandat avec cette RUM pour le marchand demandé Monext Propriétaire Page 19 / 20
6.2. Codes résultat signature Code Payline Libellé court Libellé long 34230 Transaction approved La signature du mandat a été effectuée. 34003 Slimpay error Un mandat existant a été réutilise. 34200 Slimpay error Les données du débiteur sont indisponibles. 34201 Slimpay error La signature du mandat a échoué. 34202 Slimpay error Le code saisit lors de la signature du mandat est incorrect. 34205 Slimpay error Les données du client incohérentes. 34219 Slimpay error Le client a annulé la procédure de signature. 34220 Slimpay error La session a expiré. 6.3. Codes résultat collecte Code Payline Libellé court Libellé long 34330 Collect succeded L ordre de prélèvement a été généré. 34300 Slimpay error Les données du débiteur sont indisponibles. 34301 Slimpay error Les données pour une demande de prélèvement sont incomplètes. 34302 Slimpay error Le montant maximal autorise pour le prélèvement a été dépassé. 34303 Slimpay error Débit directe est suspect. 34304 Slimpay error Débit directe n'est pas autorisé. 34305 Slimpay error Les données du client est incohérentes. 34319 Slimpay error Le client a annulé la transaction. 34320 Slimpay error La session a expire. Monext Propriétaire Page 20 / 20