PayPal est un moyen de paiement qui vous permet de payer en ligne sans communiquer vos données financières, en s'identifiant simplement avec votre adresse électronique et un mot de passe.
Cette page est destinée aux commerçants et intégrateurs qui souhaitent intégrer le moyen de paiement PayPal via Payline dans votre application de vente.
L'acheteur doit ouvrir un compte PayPal gratuit sur lequel il pourra utiliser des fonds disponibles sur son solde PayPal ou d'autres sources d'approvisionnement (carte de paiement, compte bancaire, solde PayPal, etc.).
Pour le commerçant, l'installation de PayPal est gratuite, et, contrairement à la majorité des solutions de paiement proposées par les banques, ne nécessite pas l'obtention d'un contrat de vente à distance (appelé contrat VAD). PayPal se rémunère exclusivement en prélevant une commission sur chaque transaction.
Le paiement par PayPal est immédiat.
Il nécessite d'avoir un contrat directement auprès de PayPal.
Payline se charge de se connecter à l'interface PayPal afin que l'acheteur puisse exécuter son paiement via le webservice.
Le commerçant doit créer un compte PayPal afin d'être crédité sur les données bancaires qu'il aura saisi lors de la création de son compte. Une fois le compte PayPal créé, le commerçant doit ajouter des droits d'accès à l'API Payline (Cf Autorisez l'API Payline sur votre compte PayPal).
Payline propose les fonctions suivantes :
En synthèse, ce moyen de paiement permet :
La fonction réautorisation n'est pas disponible.
Ce moyen de paiement fonctionne en mode synchrone.
Les identifiants transaction Paypal sur Payline correspondent à ceux transmis par Paypal.
Lien vers le site web : https://www.paypal.com/fr
Ce chapitre explique comment intégrer rapidement PayPal via Payline dans votre application de vente. Nous vous recommandons de réaliser chaque étape afin de garantir une bonne intégration de PayPal dans Payline.
Payline préconise de procéder à des demandes de paiement dans l'environnement d'homologation Payline avant de passer en production.
Les deux environnements réalisent les mêmes traitements, excepté qu'aucun paiement n'est envoyé aux acquéreurs. Néanmoins, à la différence de la production, en environnement d'homologation, la création d'un compte PayPal n'est pas requise, un compte de test est à votre disposition.
Vous avez déclaré votre société au registre du commerce, possédez un n° de SIRET et une adresse email valide.
Vous avez souscrit au produit Payline avec l'option « Paiement via PayPal ».
Afin de vous familiariser avec ce moyen de paiement et sa configuration, nous vous conseillons de créer dans un premier temps un compte PayPal sur lequel vous pourrez réaliser des paiements sur l'environnement d'homologation via Payline comme la procédure ci-après le décrit :
Vous devez créer un compte commerçant sur PayPal à cette adresse internet : http://www.paypal.fr
Afin de créer un contrat PayPal sur Payline, en homologation, rendez-vous sur le centre d'administration dans l'onglet « Configuration » puis « Vos moyens de paiement ». Un écran de recherche s'affiche, cliquez alors sur le bouton « Nouveau moyen de paiement ».
Écran de recherche de moyen de paiement
Écran de création de moyen de paiement 1/2
Sélectionnez votre point de vente puis le type de moyen de paiement PAYPAL comme ci-dessous.
Cliquez ensuite sur le bouton « Suivant ».
Écran de création de moyen de paiement 2/2:
Renseignez un libellé, un numéro de contrat de votre choix puis sélectionnez votre devise. Cliquez sur le statut « Actif » et renseignez votre adresse email de compte PayPal.
Le commerçant peut configurer les paramètres spécifiques :
Note du 06/02/2017 : Nouvelle adresse API en homologation : plateformefront.payline_api1.monext.net Ensuite en cas de problème pour les commerçants ayant déjà un compte PayPal il faut mettre a jour le compte chez PayPal. |
Cliquer sur le bouton « Sauvegarder » pour finaliser la création du moyen de paiement.
Votre moyen de paiement PayPal vient d'être créé, félicitations !
Cette procédure est présentée à titre indicatif, veuillez vous reporter à la documentation PayPal pour tout complément ou changement.
Création d'un compte PayPal
Pour vous connecter à l’environnement de test, il vous faut un compte PayPal. Vous pouvez utiliser un compte PayPal existant ou créer un compte spécialement à cet effet. Dans ce dernier cas, pas besoin d’y ajouter de moyen de paiement, il suffit de confirmer l’email (un email sera envoyé à l’adresse mail déclarée pour ouvrir le compte il faudra cliquer sur le lien).
Pour créer ce compte, rendez-vous sur www.paypal.fr et cliquez sur « ouvrir un compte » en haut à droite.
Création d'un compte de test
Aller à https://developer.paypal.com puis connectez-vous avec le compte créé sur https://paypal.com
Cliquez sur Applications puis sur Sandbox accounts puis créer 2 comptes préconfigurés:
|
Ensuite se connecter sur https://sandbox.paypal.com :
|
Une liste d'options s'affiche. Cochez les options:
Pour configurer PayPal 1 Clic, vous devez sélectionner les options :
|
La configuration de votre compte PayPal en Homologation est terminée.
Pour utiliser PAYPAL dans Payline, vous bénéficiez des fonctions de paiement suivantes :
Le web service doWebPayment
La fonction « doWebPayment » permet d'initialiser une transaction de paiement web avant de rediriger votre client sur les pages de paiement Payline :
Le web service getWebPaymentdetails
Pour réaliser une demande de résultat de la transaction de paiement, Payline met à votre disposition ce web service. Vous devez transmettre le jeton d'authentification délivré par Payline lors de la demande d'initialisation (résultat de la fonction doWebPayment) pour obtenir un résultat détaillé du paiement.
Mode d'intégration
Payline offre la possibilité au commerçant de définir depuis son compte commerçant le mode d'affichage des pages PayPal : mode redirection plein écran ou mode lightbox.
Dans le cas d'un affichage en mode lightbox, Payline affiche les pages de paiement PayPal d'authentification et de confirmation dans une fenêtre en superposition de la boutique en ligne.
Dans le cas d'un affichage en mode redirection, Payline redirigé l'acheteur sur les pages de paiement PayPal.
Vous pouvez réaliser les opérations d'encaissement correspondant au montant initial de vos transactions PayPal :
Vous pouvez réaliser le remboursement de vos transactions PayPal depuis Payline par le Web Service « doRefund » ou par notre centre d'administration.
La limite du montant des remboursements correspond par défaut au montant de la transaction d'origine.
Si vous souhaitez modifier ces limites, vous pouvez contacter votre responsable commercial PayPal.
Toutes les transactions PayPal, acceptées, refusées et impayés, apparaissent dans le fichier « Liste des transactions » de Payline.
Ce fichier peut être généré manuellement depuis notre centre d'administration ou automatiquement transmis sur vos serveurs par transfert de fichier sécurisé.
Certaines informations provenant de PayPal sont retournées au commerçant dans la structure PartnerAdditionalData de l'objet transaction avec une structure JSON contenant :
- Email du compte acheteur PayPal ;
- Statut du compte (verified/unverified) ;
- Pays du compte (ISO3166) ;
- Identifiant de la transaction PayPal est restitué dans a balise referenceID pour les version de l'API supérieure ou égale à 16.
Le champ est valorisé pour chaque transaction réalisée avec PayPal si au moins un des 3 informations est disponible et pour une version du service 16 ou supérieur avec le typeCarte = PAYPAL.
Cette structure sera retourné dans les réponses des services : getTransactionDetails et getWebPaymentDetails.
Exemple de la structure
<AdditionalData>
{"login":"VALEUR_EMAIL",
"accountStatus":"VALEUR_PAYERSTATUS",
"accountCountryCode":"VALEUR_COUNTRYCODE"}
</additionalData>
Les web services GetCards et GetWallet contennent les mêmes informations du ou des comptes PayPal contenu dans le wallet interrogé si un ou plusieurs comptes PayPal y sont enregistrés.
Les informations sont les mêmes que celles retournées dans le GetWebPaymenDetails.
Instant Payment Notification (IPN)
Toutes les modifications d'une autorisation envoyée par Payline dans le centre administration de PayPal, seront notifiées à Payline par PayPal.
Le nom commercial et le logo seront envoyés à PayPal. Ces paramètres sont configurés dans le contrat du moyen de paiement.
La langue sera configurée lors de l'appel au service de paiement.
Nom de la ligne dans la table WEB_PAYMENT | Valorisation |
---|---|
LANGUAGE_CODE | doWebPayment : languagecode |
L'information affichée sur le relevé de compte de l'acheteur et sur le ticket de paiement peut être transmise à PayPal.
Le champ softdescriptor des objets Transaction et Payment de l'API Payline est étendu à 127 caractères spécifiquement pour PayPal.
Pour les pays suivant Argentina, Brazil, Canada, China, Indonesia, India, Japan, Mexico, Thailand or USA; l'adresse de livraison n'est pas envoyée si l'un des champs obligatoire est manquant : nom, rue, ville, pays et état.
Address.Name, Address.Street1, Address.CityName, Address.gountry, Address.Country, Address.State.
Cette procédure est présentée à titre indicatif, veuillez vous reporter à la documentation PayPal pour tout complément ou changement.
Cette étape vous permet de créer un compte PAYPAL dans l'environnement de production, nécessaire pour l'intégration de ce moyen de paiement dans Payline. Si vous avez testé PayPal en environnement sandbox, c'est que vous avez déjà un compte PayPal business. Vous pouvez configurer directement ce compte.
Suivez pas à pas les indications suivantes :
Cocher les options :
Pour configurer PayPal 1 Clic, vous devez sélectionner les options :
|
Vous devez vous rapprocher de votre responsable de compte partenaire pour obtenir les informations nécessaires permettant de configurer votre compte de production sur Payline (contrat vad, id et mot de passe).
Ensuite veuillez adresser un email à notre équipe support avec les informations, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.
Ce numéro de contrat (alias) vous permettra d'effectuer les paiements.
Cette étape vous permet de contrôler que votre intégration est correcte.
Le principe du paiement en 1 clic est de permettre au consommateur de payer chez un commerçant sans avoir à s'authentifier sur PayPal à partir du deuxième achat.
Payline propose au commerçant de définir depuis son compte commerçant s'il autorise ou non les paiements en 1 clic et propose la gestion par l'API :
Les limites sont les suivantes :
Un identifiant de wallet correspond à un External_Wallet_ID, ceci suffit à identifier le wallet PayPal courant qui est unique.
L'option '1-clic' est utilisée par le commerçant si le « doWebPayment » contient un identifiant de wallet et un seul contrat VAD.
Il existe un accord de paiement s'il existe un Wallet avec External_Wallet_ID égal aux arguments reçus via le « doWebPayment » et si la case à cocher de l'accord de paiement a été sélectionnée.
L'accord d'enregistrement peut être transmis en paramètre de la fonction doWebPayment avec un PrivateData dont la clé est recordingAgreement, la valeur est 'Y'.
Le service doImmediateWalletPayment est également disponible pour réaliser les paiements : SI l'option '1-clic' est configurée et activée et s'il existe un accord de paiement.
WALLET | Valorisation |
---|---|
LASTNAME | doWebPayment : buyer.lastName |
FIRSTNAME | doWebPayment : buyer.firstName |
doWebPayment : buyer.email | |
EXTERNAL_WALLET_ID | doWebPayment : buyer.walletId |
IP | doWebPayment : buyer.ip |
Voir l'objet buyer de l'API Payline.
1er paiement : exemple de page de redirection avec utilisation du portefeuille virtuel
page de paiement v1 :
avec le widget :
Paiement suivant : exemple de page de redirection avec utilisation du portefeuille virtuel
Gestion du portefeuille
Le service manageWebWallet permet à l'acheteur la suppression du moyen de paiement PayPal d'un portefeuille.
Vous devez sélectionner deux nouvelles options sur votre compte Paypal dans vos environnement d'homologation et de production.
Vous devez configurer le point de vente avec les options suivantes :
Le principe de cette amélioration consiste à proposer au consommateur d'utiliser un autre mode de paiement en cas d'échec de paiement.
PayPal propose à ses commerçants le mode ExpressCheckOut, en intégrant un bouton spécifique directement sur la page de la commande. Avec cette méthode, le consommateur peut acheter sur le site commerçant sans avoir à saisir ses données personnelles (nom, prénom, adresses de livraison et de facturation, moyen de paiement…), voire même sans devoir au préalable créer un compte acheteur sur le site. Le commerçant n’a plus qu'à rediriger le consommateur vers une page de paiement : Payline va directement injecter les éléments dans la page du site commerçant.
Lorsque le consommateur se trouve à l’étape de la revue de commande, le commerçant peut proposer des modifications : changement des adresses, du mode de livraison,… Il est également possible de proposer des services additionnels (assurance, produit complémentaire, …).
L'expérience utilisateur d'un paiement se résume à :
Les pages de paiement :
Étape 1 : Validation du panier
Inutile de créer un compte pour le consommateur : données personnelles, adresse de livraison, facturation...
Étape 2 : Authentification du consommateur
Étape 3 : Validation de l'adresse et du moyen de paiement
Étape 3 : Finalisation du paiement
Lorsque le consommateur se trouve à l’étape de la revue de commande, le commerçant peut proposer des modifications : changement des adresses, du mode de livraison, …
Il est également possible de proposer des services additionnels (assurance, produit complémentaire, …). Le montant de la commande ainsi que les informations de commandes peuvent changer et doivent être enregistrés dans la base de données.
Page de finalisation de la commande : la transaction est effective et enregistrée une fois que acheteur effectue l'action de finaliser sa commande.
L’API JavaScript de Payline autorise ces changements. Le commerçant peut passer les modifications à Payline avant validation du paiement (le contrat doit être paramétré pour ce cas). |
Vous devez entrer en contact avec notre équipe support pour demander l'activation de ce moyen de paiement dans votre compte commerçant.
Une fois le moyen de paiement activé, il vous suffit d'utiliser l'API WebPayment et les fonctions suivantes :
En mode widget, lors de l'appel du doWebPaiement, seul email du buyer sera pris en compte par Payline, les informations du buyer seront retournées par PayPal.
Ensuite vous devez récupérer le Token et préciser l'option data-template="shortcut".
<div id="PaylineWidget" data-token="1mzreM6MGwh2GZO276317895190386597" data-template="shortcut" data-event-didshowstate="showStateFunction" </div> |
En retour de PayPal, le commerçant pourra utiliser l'API JavaScript de Payline : voir l'intégration Widget avec les events, fonctions API et CallBack.
Payline préconise de contrôler l'état de la transaction avec l'option data-event-didshowstate, ceci dans le but de récupérer les informations de l'acheteur, éventuellement proposer d'autres options à la commande et surtout de finaliser la transaction avec la fonction finalizeShortcut().
Exemple de la fonction showStateFunction permettant « d’intégrer » la cinématique Shortcut :
function showStateFunction(state) { if ("PAYMENT_METHODS_LIST_SHORTCUT" == state.state) { //traitement particulier au besoin de l’intégration du commerçant ... } if ("PAYMENT_TRANSITIONAL_SHORTCUT" == state.state) { // 1) Mise à jour du montant: // 1.a) Preparation de JSON var updateCart = { "payment": { "amount": "1500", "currency": "978" } }; // 1.b) Mise à jour du webPaiement via api JS Payline.Api.updateWebpaymentData(token, updateCart, function (response) { if (response._status) { // Traiter la reponse au besoin // Appeler la fonction finalizeShortcut pour mettre à jour le panier // La mise à jour du panier devrait être faite suite au click sur un bouton payer géré par le marchand ... } }); // 2) Finalisation du paiement Shortcut Payline.Api.finalizeShortcut(); } if ("PAYMENT_SUCCESS" == state.state) { //traitement particulier au besoin de l’intégration du commerçant } } |
De la même manière qu'un contrat PayPal, voir l'intégration PayPal.
Le commerçant doit vérifier les options et contrôler la phase pilote :
'J'accepte les mises à jour du contenu' du point de vente | Cette option permet à l'API Javascript Payline de prendre en compte les modifications du montant sur le site commerçant après la validation sur PayPal. |
'J'active la proposition d'un second moyen de paiement' du contrat | Cette option permet de proposer un autre moyen de paiement en cas de refus du premier. |
'J'active la fonctionnalité paiement en '1 clic' du contrat | Cette option permet n'est pas prise en compte pour le mode ExpressCheckOut. L'authentification de l'acheteur est réalisé par PayPal. |
Le tableau ci-dessous permet de recenser l'ensemble des codes et messages de retour Payline pour PAYPAL ainsi que leur destinataire.
Les codes et messages suivants seront renvoyés par l'objet Résultat :
Note : Lorsque Payline n'a aucun retour du consommateur une fois redirigé chez PayPal, par exemple : lorsque le navigateur est fermé, vous recevrez une notification de refus avec le motif CANCELLED et un code 02319.