Guide d implémentation Intégration du moyen de paiement PayPal Paiement immédiat (Mode Sale) Version 1.1 Guide d implémentation - Paypal 1/15
SUIVI, HISTORIQUE Rédaction, Vérification, Approbation Rédaction Vérification Approbation Nom Date/Visa Nom Date/Visa Nom Date/Visa Lyra-Network 29/03/13 Lyra-Network 29/03/13 Lyra-Network 29/03/13 Historique du document Version Auteur Date Commentaires 1.1a Lyra-Network 29/03/13 Précisions sur l état «Vérification par PayPal» 1.1 Lyra-Network 11/06/12 Ajout de paramètres Paypal supplémentaires et facultatifs dans le formulaire de paiement 1.0 Lyra-Network 24/08/2011 Version initiale. 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. Guide d implémentation - Paypal 2/15
SOMMAIRE Suivi, historique... 2 1. Presentation... 4 2. Pré requis... 4 2.1: Création d un compte PayPal... 4 3. Paramétrage depuis le back office... 4 3.1: Ajout et paramétrage du contrat (Back office commerçant)... 4 3.2: Gestion des habilitations... 5 3.3: Association à la boutique... 5 4. Cinématique de paiement... 6 5. Détail des paiements... 8 6. Opérations possibles sur les transactions... 9 6.1: Rembourser... 9 6.2: Editer la référence commande... 10 6.3: Renvoyer l email de confirmation... 11 6.4: Rapprocher manuellement... 11 7. Formulaire de paiement... 12 7.1: Paramètre paiement... 12 7.2: Délai de capture... 12 7.3: Paramètre de validation... 12 7.4: Paramètres supplémentaires optionnels Formulaire de paiement... 12 7.4.1: Liste des paramètres... 12 7.4.2: Cohérence des champs... 14 7.4.3: Affichage sur la page de paiement :... 15 Guide d implémentation - Paypal 3/15
1. PRESENTATION Ce document présente le moyen de paiement PayPal et son intégration dans la plateforme Payzen. 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 Entreprise: 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 suivant: https://www.paypal-france.fr/marchands/ Dans l onglet marchant, vous avez une multitude d offre. Choisissez celle qui vous convient le mieux, puis renseignez les champs demandés. 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. 3. PARAMETRAGE DEPUIS 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 : Guide d implémentation - Paypal 4/15
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 Live : Mode production 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é au compte. N oubliez pas de cliquer sur sauvegarder pour que le paramètre soit enregistré. Guide d implémentation - Paypal 5/15
4. CINEMATIQUE DE PAIEMENT L internaute finalise sa commande sur le site marchand, en choisissant le logo PayPal il est redirigé sur la plateforme de paiement PayPal : Guide d implémentation - Paypal 6/15
L internaute devra s identifier et sera redirigé sur cette page : Ainsi l internaute pourra vérifier si le montant est correct avant de valider son paiement. En cliquant sur le bouton payer, il sera redirigé sur la plateforme Payzen qui affichera le résultat du paiement : Guide d implémentation - Paypal 7/15
5. DETAIL DES PAIEMENTS Avec le paiement immédiat, le délai de capture est égal à zéro. Cela signifie que les fonds seront directement capturés. Il n y aura donc aucune notion d autorisation. Une fois le paiement terminé, il apparait directement dans l onglet «Paiement Remis» du Back Office Marchand. Nous allons vous présenter un exemple de transaction. Pour accéder aux détails d une transaction, effectuez un clic droit sur la transaction voulue puis sélectionnez «Afficher le détail d une transaction». Compte PayPal marchand Type de la transaction - Débit dans le cadre d un paiement. - Crédit dans le cadre d un remboursement. Montant de la transaction Statut «Présenté» pour paiement immédiat. Compte PayPal du client qui a effectué la transaction. Certificat Paypal de la transaction 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). Guide d implémentation - Paypal 8/15
6. OPERATIONS 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. 6.1: Rembourser Au même titre que pour les transactions de carte bancaire, il est possible de rembourser une partie du montant, jusqu à la totalité. Dans ce cas, plusieurs remboursements sont possibles. Pour effectuer un paiement dans le back office, vous devez cliquer sur le bouton rembourser comme ci-dessous. Dans le cas présent, le montant est de 48 Euros et un remboursement de 18 Euros a été réalisé. Guide d implémentation - Paypal 9/15
Une fenêtre s ouvre automatiquement vous présentant le remboursement que vous avez effectué. 6.2: 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. Une fenêtre s ouvre, modifiez librement la référence de votre commande puis cliquez sur OK. Guide d implémentation - Paypal 10/15
6.3: Renvoyer l email de confirmation Dans le cas ou le commerçant ou le client n aurait pas reçu d email de confirmation, il est également possible de renvoyer cet email. Pour envoyer un email, il suffit de faire un clic droit sur la transaction, puis de sélectionner votre choix. 6.4: Rapprocher manuellement Payzen offre également la possibilité de créer un rapprochement manuel. Vous devez également faire un clic droit sur votre transaction et sélectionner Rapprocher manuellement. Après une demande de confirmation, une fenêtre s ouvre pour que vous puissiez saisir un commentaire. Le statut de rapprochement change en «Rapproché» Guide d implémentation - Paypal 11/15
7. FORMULAIRE DE PAIEMENT 7.1: Paramètre paiement Dans votre formulaire de paiement (voir le guide d implémentation formulaire de paiement ), 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 En paiement immédiat, le délai de capture doit être vide, à 0 ou ne doit pas être renseigné. Dans le cas contraire, la plateforme de paiement affichera une erreur. 7.3: Paramètre de validation Pour un paiement immédiat, le paramètre de validation doit être en automatique. Même si vous renseignez le paramètre de validation en manuel, il sera validé automatiquement. 7.4: Paramètres supplémentaires optionnels Formulaire de paiement 7.4.1: Liste des paramètres 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 Guide d implémentation - Paypal 12/15
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 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 Guide d implémentation - Paypal 13/15
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 7.4.2: 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. Guide d implémentation - Paypal 14/15
7.4.3: 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 : Guide d implémentation - Paypal 15/15