Guide d implémentation Interface du moyen de paiement PayPal Paiement Différé Version 1.1a
Rédaction, Vérification, Approbation Rédaction Vérification Approbation Nom Date/Visa Nom Date/Visa Nom Date/Visa Lyra-Network 29/03/2013 Lyra-Network 29/03/2013 Lyra-Network 29/03/2013 Historique du document Version Auteur Date Commentaires 1.1a Lyra-Network 29/03/2013 Précisions sur l état «Vérification par PayPal» 1.1 Lyra-Network 11/06/2012 Ajout de paramètres Paypal supplémentaires et facultatifs dans le formulaire de paiement 1.0 Lyra-Network 15/05/2012 Création du document. 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 PRESENTATION... 4 2 PRE REQUIS... 4 2.1 CREATION D UN COMPTE PAYPAL... 4 3 PARAMETRAGE DEPUIS DE LE BACK OFFICE... 5 3.1 AJOUT ET PARAMETRAGE DU CONTRAT (BACK OFFICE COMMERÇANT)... 5 3.2 GESTION DES HABILITATIONS... 6 3.3 ASSOCIATION A LA BOUTIQUE... 6 4 PAIEMENT DIFFERE... 6 4.1 DELAI CAPTURE INFERIEUR OU EGAL A 3 JOURS... 6 4.2 DELAI CAPTURE SUPERIEUR A 3 JOURS... 6 5 OPERATIONS POSSIBLES SUR LES TRANSACTIONS... 8 5.1 VALIDER... 8 5.2 MODIFIER... 9 5.3 ANNULER... 12 5.4 EDITER LA REFERENCE COMMANDE... 12 5.5 RENVOYER L EMAIL DE CONFIRMATION... 13 5.6 EXPIRATION DE LA TRANSACTION... 13 6 OPERATIONS SPECIFIQUES EN MULTI CAPTURE... 13 6.1 PRESENTATION... 13 6.2 PROCEDURE MULTI CAPTURE... 14 6.3 CLOTURER... 16 7 FORMULAIRE DE PAIEMENT... 17 7.1 PARAMETRE PAIEMENT... 17 7.2 DELAI DE CAPTURE... 17 7.3 PARAMETRE DE VALIDATION... 17 7.4 PARAMETRE SUPPLEMENTAIRES... 18 7.4.1 Cohérence des champs.... 20 7.4.2 Affichage sur la page de paiement :... 20
1 PRESENTATION Ce document présente le moyen de paiement PayPal et son intégration dans la plateforme Systempay. 2 PRE REQUIS La transaction de paiement se fait entre le compte marchand et le compte client, vous devez donc avoir impérativement un compte PayPal "Professionnel" : Soit vous ne possédez pas de compte PayPal, dans ce cas, il faudra en créer un comme dans le chapitre 2.1, Soit vous possédez déjà un compte PayPal et dans ce cas, vous pouvez passer directement au chapitre 3. 2.1 Création d un compte PayPal Pour commencer, vous devez créer un compte marchand ; connectez vous sur le site Paypal : https://www.paypal.com/fr/webapps/mpp/accueil-professionnel Dans l onglet "Solutions de paiement", choisissez "PayPal Option +", et cliquez sur le bouton "Ouvrez un compte Pay Pal" renseignez les champs demandés., puis Attention : A la fin de l inscription, PayPal vous enverra un mail de confirmation de l inscription. Il est important de le faire sinon votre compte ne sera pas actif. Lyra Network- 4/20
3 Paramétrage depuis de le Back Office 3.1 Ajout et paramétrage du contrat (Back Office commerçant) Paramétrage/ Enseigne / Comptes PayPal Cliquez ensuite sur Ajouter un compte existant : Une nouvelle fenêtre apparait : Détail des champs à renseigner : - Email : Paramètre obligatoire. Il s agit de votre email PayPal Professionnel. - Mode du compte : Sandbox : Mode test Lyra Network- 5/20
Live : Mode production - Devise 3.2 Gestion des habilitations Pour recevoir les paiements sur le compte PayPal, il est indispensable de donner l habilitation : En cliquant sur ce bouton, vous allez être redirigé sur le site PayPal, où il vous sera demandé de vous identifier et d accepter les permissions. 3.3 Association à la boutique Pour proposer le moyen de paiement PayPal il faut associer le contrat à votre boutique. Ce paramétrage se fait en cochant la case boutique associée au compte. N oubliez pas de cliquer sur sauvegarder pour que le paramètre soit enregistré. 4 Paiement différé Le délai de capture est strictement supérieur à 0. Comme pour un paiement par Carte Bancaire, le comportement diffère si le délai de capture est supérieur à la durée de validité de l autorisation. Il est de 3 jours pour PayPal au lieu de 6 pour la CB. 4.1 Délai capture inférieur ou égal à 3 jours Une autorisation est effectuée le jour du paiement. La capture sera faite le jour de la date de présentation demandée. 4.2 Délai capture supérieur à 3 jours Le jour du paiement, une opération semblable à la prise d empreinte est réalisée. L autorisation sera elle réalisée 3 jours avant la date de présentation demandée. Lyra Network- 6/20
La capture est toujours faite le jour de la date de présentation. Veuillez trouver ci dessous un exemple de transaction pour un paiement différé avec un délai de 10 jours : - Date de création de la transaction. - Statut : En attente d auto : seul une demande d empreinte a été réalisée. L autorisation sera faite ultérieurement - Date de présentation demandée, soit 10 jours après la création. Le paiement est réalisé le 24/08/2011 La date de présentation demandée est le 03/09/2011 La demande d autorisation sera réalisée le 31/08/2011 soit 3 jours avant la date de présentation demandée. - Mention empreinte, uniquement en mode différé. Dans de rares cas, PayPal retient la transaction pour suspicion de fraude (état «Vérification par PayPal»). Le paiement est alors dans l onglet Paiement en cours. ATTENTION : Lors de l appel à l URL serveur pour une transaction en «Vérification par PayPal», la variable vads_result est retournée à 00. Il est donc important de vérifier également dans votre script que la variable vads_trans_status ne soit pas en UNDER_VERIFICATION (vérification par PayPal). Lyra Network- 7/20
5 Opérations possibles sur les transactions Pour effectuer une opération, vous devez faire un clic droit sur la transaction que vous souhaitez. Une fenêtre s ouvre comme ci-dessus, vous avez un choix d options qui sont détaillés ci dessous. 5.1 Valider Le mode de validation est automatique pour les paiements immédiats. En revanche, pour le paiement différé, le marchand aura la possibilité de valider le paiement ou de le laisser en validation automatique. Si vous choisissez la validation manuelle, vous devrez valider le paiement ultérieurement. Dans ce cas la transaction aura comme statut A valider (délai de capture initial inferieur à 3 jours) ou A valider et autoriser (délai initial supérieur à 3 jours). Statut A valider Choisissez donc votre transaction et cliquez sur «Valider» puis une fenêtre de confirmation s ouvrira. Vous visualisez le nouveau statut de la transaction Le statut d un paiement avec un délai de capture inférieur ou égal à 3 jours, après la validation, est «En attente de remise» Lyra Network- 8/20
Statut A valider et autoriser Choisissez donc votre transaction et cliquez sur «Valider» puis une fenêtre de confirmation s ouvrira. Vous visualisez le nouveau statut de la transaction Le statut d un paiement avec un délai de capture supérieur à 3 jours, après la validation, est «En attente d auto» L autorisation sera réalisée à j-3 avant la date de présentation fixée initialement. 5.2 Modifier L option modifiée est uniquement possible sur les transactions ayant comme statut : - A valider - A valider et autoriser - En attente d auto. - En attente de remise Montant Contrairement au paiement immédiat, tant que la transaction n a pas atteint la date de présentation, il est possible pour le marchand de modifier le montant. Le nouveau montant doit être inférieur au montant initial. Date de présentation Il est également possible de modifier la date de présentation, de reculer ou d avancer celleci. - Pour les transactions ayant un statut «en attente de remise» ou «à valider» la plage possible de présentation est de 3 jours. En effet la demande d autorisation valable 3 jours a déjà été effectuée. Lyra Network- 9/20
Exemple ci-dessous : - Pour les transactions ayant un statut «A valider et autoriser» ou «En attente d auto» vous pouvez choisir la date de votre choix. Exemple ci-dessous : Choisissez donc l option comme ci-dessous pour procéder à la modification du montant. Renseignez le nouveau montant et la nouvelle date de présentation si nécessaire. Lyra Network- 10/20
Après avoir validé la modification de la transaction, si on affiche les détails, nous pouvons constater le changement : Montant initial lors de la transaction effectué par le client. Montant actuel Date de présentation modifiée. REMARQUE Si la modification est réalisée sur un paiement non validé (statut à valider ou à valider et autoriser) alors il sera possible de valider la transaction comme ci-dessous : Lyra Network- 11/20
5.3 Annuler Tant que la transaction n a pas atteint la date de présentation, il est possible d annuler la transaction. Pour cela, faites un clic droit sur votre transaction et sélectionnez le bouton cidessous. Une fenêtre de confirmation s ouvrira, choisissez OK pour continuer. Détail de la transaction : Le statut de la transaction devient «Annulé». 5.4 Editer la référence commande Vous avez la possibilité d éditer la référence commande. Pour cela faites un clic droit sur la transaction puis sélectionnez le champ suivant. Lyra Network- 12/20
Une fenêtre s ouvre, modifiez librement la référence de votre commande puis cliquez sur OK. 5.5 Renvoyer l email de confirmation Comme pour le paiement immédiat, il est possible de renvoyer un email de confirmation. Pour cela faites un clic droit sur la transaction, puis sélectionnez votre choix. 5.6 Expiration de la transaction Tous les paiements dans un statut «A valider ou A valider et autoriser» expirent à la date de présentation demandée si ces derniers n ont pas été validés manuellement. Le statut de la transaction est «Expiré» 6 Opérations spécifiques en Multi Capture 6.1 Présentation Le mode multi capture est une option de PayPal qui se configure sur le compte marchand. Il est possible que vous n ayez pas cette option si vous n avez pas souscrit à l offre multicapture. Rapprochez vous de PayPal pour en savoir plus pour cette option. Cette option doit être également rajoutée sur votre compte Systempay. Le mode multi capture permet de capturer en plusieurs fois une partie du montant ou sa totalité. Exemple 1 : Totalité du montant Un paiement de 100 euros pour 2 articles (30 euros et 70 euros) - Départ livraison premier article => débit 30 euros - Départ livraison 2eme article => débit 70 euros - Clôture définitive de la commande Lyra Network- 13/20
Exemple 2 : montant partiel Un paiement de 100 euros pour 2 articles (30 euros et 70 euros) Départ livraison premier article => débit 30 euros Clôture définitive de la commande 6.2 Procédure multi capture Ci-dessous la transaction sur laquelle sera appliquée l option multi capture. Le montant initial de la transaction dans cet exemple est de 100 euros. Etape 1 : Annulation Cette opération d annulation permet d annuler définitivement la commande. Avec l option multi-capture la commande reste cependant ouverte. Sélectionnez la transaction, effectuez un clic droit et sélectionnez Annuler La transaction est annulée mais la commande reste ouverte. Etape 2 : Dupliquer Cette opération permet de dupliquer la transaction annulée en indiquant un montant partiel et la date de présentation. Sélectionnez la transaction annulée, effectuez un clic droit et sélectionnez Dupliquer La fenêtre de duplication apparaît à l écran, Saisir le montant partiel (exemple 70 euros) et la date de présentation. Fixez le montant. Fixez la date de présentation au jour même si vous souhaitez capturer le montant immédiatement. Lyra Network- 14/20
Ecran suivant : Vous avez donc capturé 70 euros sur 100 euros. Vous pouvez renouveler plus tard cette opération pour capturer le montant restant (30 euros) comme décrit ci-dessous. Sélectionnez la transaction annulée de 100 euros. Clic droit puis «dupliquer» : Fixez le montant. Fixez la date de présentation dans 6 jours si vous souhaitez par exemple débiter ce montant dans 6 jours. Ecran suivant : Vous avez donc capturé 30 euros. Résumé de la visualisation sur le back office Cette ligne correspond à la transaction initiale de 100 euros qui a été annulé. Cette ligne correspond à la première capture partielle de 70 euros. Cette ligne correspond à la deuxième capture de 30 euros. Lyra Network- 15/20
La totalité du montant de la transaction initiale a été capturée. Plus aucun autre montant ne sera capturé pour cette transaction. Il est possible de clôturer la commande auprès des services de PayPal. ATTENTION : Cette opération de «clôture» ne devra être réalisée que lorsque tous les paiements auront été envoyés à PayPal. Cela signifie que les paiements liés à la commande sont visualisables dans l outil de gestion de caisse dans l onglet paiement remis. Remarque : Il est possible de clôturer une transaction même si celle-ci a été capturée partiellement. A noter une fois la transaction clôturée plus aucune autre capture ne sera autorisée. 6.3 Clôturer Une fois que les transactions de capture partielle seront envoyées à PayPal, et donc remontées dans l onglet paiement remis, vous pouvez clôturer la commande. Si vous ne réalisez pas cette étape, votre client verra dans son compte PayPal «paiement en cours» indéfiniment. ATTENTION: si vous clôturez la commande alors que certaines transactions rattachées à cette commande se situent toujours dans l onglet paiement en cours, vous annulerez ces transactions. Soyez donc vigilent et attendez que tous les paiements rattachés à une commande se situent dans l onglet «Paiement remis» avant d effectuer une clôture. Lyra Network- 16/20
7 Formulaire de paiement 7.1 Paramètre paiement Dans votre formulaire d envoi, il est possible de rajouter un paramètre nommé vads_payment_cards. Celui-ci vous permettra d envoyer l internaute directement sur la page PayPal, autrement dit sans avoir à choisir le mode de paiement. Le paramètre à rajouter est le suivant : vads_payment_cards = PAYPAL_SB => pour le mode test vads_payment_cards = PAYPAL =>pour le mode production Si vous laissez vide le paramètre alors sera proposé l ensemble des moyens de paiement (CB, PayPal, etc...). 7.2 Délai de capture Dans le formulaire il est possible de préciser le délai de remise à PayPal. Le paramètre à rajouter ou modifier dans votre formulaire est : vads_capture_delay = valeur exprimé en jour (nombre entier) Le délai de capture égal zéro correspond au paiement immédiat (chapitre 3.1) Le délai de capture supérieur ou égal à 1 correspond au paiement immédiat (chapitre 3.2) 7.3 Paramètre de validation Dans le formulaire il est possible de préciser le type de validation d une transaction. Le paramètre à rajouter ou modifier dans votre formulaire est : vads_validation_mode = 1 => mode manuel vads_validation_mode = 0 => mode automatique ATTENTION : dans le cas d un délai de capture égal à 0 il est impératif d avoir un type de validation positionnée à automatique. vads_validation_mode = 0 => mode automatique Ce paramètre est décrit dans la documentation chapitre 5.2.1 Pour plus d information veuillez consulter la documentation d intégration du formulaire de paiement sur le site documentaire Systempay. Lyra Network- 17/20
7.4 Paramètre supplémentaires vads_product_amountn Ce paramètre permet de définir le montant des différents articles contenus dans le panier. N correspond à l indice de l article. (0 pour le premier, 1 pour le deuxième article etc ) Ce champ sera affiché sur la page de paiement de Paypal. Le montant sera exprimé dans l unité la plus petite de la devise. Le centime pour l euro. Exemple Pour 10 euros => vads_product_amount0=1000 vads_product_labeln Ce paramètre permet de définir le label de chacun des articles contenus dans le panier. N correspond à l indice de l article. (0 pour le premier, 1 pour le deuxième article etc ) Ce champ sera affiché sur la page de paiement de Paypal. Le champ est de longueur max 127 et de type alpha numérique. Caractères spéciaux non autorisés. Exemple : vads_product_label0= Coque téléphone portable inox vads_product_qtyn Ce paramètre permet de définir la quantité de chacun des articles contenus dans le panier. N correspond à l indice de l article. (0 pour le premier, 1 pour le deuxième article etc ) Ce champ sera affiché sur la page de paiement de Paypal. Le champ est de longueur max 12 et de type numérique Exemple : vads_product_qty0=2 vads_product_refn Ce paramètre permet de définir une référence pour chacun des articles contenus dans le panier. N correspond à l indice de l article. (0 pour le premier, 1 pour le deuxième article etc ) Ce champ sera affiché sur la page de paiement de Paypal. Le champ est de longueur max 12 et de type numérique Exemple : vads_product_qty0=2 Lyra Network- 18/20
vads_nb_products Ce paramètre permet de définir le nombre de produits contenu dans le panier. Attention ce champ est obligatoire pour que le panier soit pris en compte Le champ est de longueur max 12 et de type numérique Exemple : vads_product_qty0=2 vads_shipping_amount Ce paramètre permet de définir le montant des frais de livraison pour l ensemble de la commande. Ce champ sera affiché sur la page de paiement de Paypal. Le montant sera exprimé dans l unité la plus petite de la devise. Le centime pour l euro. Exemple Pour 10 euros => vads_shipping_amount=1000 vads_tax_amount Ce paramètre permet de définir le montant des taxes pour l ensemble de la commande. Ce champ sera affiché sur la page de paiement de Paypal. Le montant sera exprimé dans l unité la plus petite de la devise. Le centime pour l euro. Exemple Pour 10 euros => vads_tax_amount=1000 vads_insurance_amount Ce paramètre permet de définir le montant de l assurance pour l ensemble de la commande. Ce champ sera affiché sur la page de paiement de Paypal. Le montant sera exprimé dans l unité la plus petite de la devise. Le centime pour l euro. Exemple Pour 10 euros => vads_insurance_amount=1000 Lyra Network- 19/20
7.4.1 Cohérence des champs. Dans le formulaire de paiement est valorisé le champ vads_amount qui correspond au montant total de la commande. La plateforme de paiement vérifie la validité de l équation suivante. Somme(vads_product_qty(N) x vads_product_amount(n)) + vads_shipping_amount + vads_tax_amount + vads_insurance_amount = vads_amount En cas d erreur le formulaire de paiement sera refusé pour une erreur de montant. 7.4.2 Affichage sur la page de paiement : Après intégration des champs complémentaires vous observerez le contenu du panier sur la page de paiement Paypal : Lyra Network- 20/20