Contenu
Cette page présente la mise en œuvre de la Page Web de Paiement Version 2 (Mode redirection).
Cette page web à redirection permet d'obtenir une page de paiement hébergée chez Payline avec le mode d'intégration widget. Le commerçant bénéficie d'un meilleur visuel et de toutes les dernières fonctionnalités mises à jour.
Plusieurs étapes sont nécessaires :
Le commerçant utilise les mêmes services des pages à redirection en indiquant le nouveau Réference Id défini dans le centre administration :
Payline se charge d'appeler la page de paiement et d'y intégrer le widget.
Les services disponibles sont :
vous devez
|
Il faut créer une page template et la charger sur le centre administration, vous avez deux options :
Option A : Télécharger l'exemple index.html lors de la création d'une nouvelle page de paiement avancée. (Mettre le lien de créer une nouvelle page de paiement)
Option B : Construire votre propre page web de paiement comme ci dessous.
La page de paiement s'affiche en mode tabulation :
Si le nombre de moyen de paiement est important alors le widget bascule en colonne.
A cela il est nécessaire d'ajouter, dans le body, une div nommée PaylineWidget avec des paramètres tels que le template choisi (parmi column, tab et lightbox, cf. la documentation du widget Mode in-Shop), des callback (cf. Fonction CallBack avec le widget).
L'exemple ci-dessous représente la création d'une div avec le template column et ajouter une callBack pour customiser le widget lorsqu'il s'agit d'un contexte de type PAYMENT_METHOD_LIST (la liste des moyens de paiement, où le consommateur aura le choix des moyens de paiement et renseignera ses données de paiement) :
|
Le code data-event-didshowstate="customPaymentMethodList", permet d'appeler la fonction JS customPaymentMethodList, lorsqu'un contexte de type PAYMENT_METHOD_LIST s'est affiché afin de personnaliser l'affichage avec, par exemple, jQuery.
Vous pouvez trouver la liste des états possibles retournés dans la callback : Fonctionnalités du Widget
Vous devez ajouter le Javascript au fichier HTML, soit créer un fichier Javascript que vous ajouterez dans notre head via un lien relatif :
|
Pour que le widget s'initialise, il faut lui fournir un token obtenu via un doWebPayment (effectuer une demande de paiement) ou un manageWebWallet (effectuer une gestion de portefeuille).
Lors du doWebPayment , l'url générée par les WebServices de l'API Payline générera une URL de la forme suivante : https://webpayment.payline.com/v2/[clé chiffrée du template]/#[TOKEN]
Il faut donc ajouter à votre javascript la fonction capable de récupérer le token dans l'url, et de la fournir au widget :
|
Cela permet au Widget de s'initialiser avec le token de l'url lors du chargement de la page.
Lorsque vous développez votre template, vous pouvez ajouter #[TOKEN] en récupérant un Token sur notre API WebServices d'homologation, les liens vers les css, js et images étant relatifs, cela vous permet d'utiliser votre template en copier tous vos fichiers dans le même dossier.
Consulter la page : Mode Redirection - Page Web de Paiement Version 2 - Personnalisation
|