Contenu 

Plus d'information

Bascule-à-la-source - Guide d'intégration commerçant


Intégration avec API WebPayment

Le mode d'intégration et les pages web de paiement intègrent de manière native une technologie de bascule à la source. En cas d'impossibilité de finaliser un paiement, il sera effectué une tentative sur le endpoint suivant.

Le mode d'intégration widget et les pages web de paiement hébergées continueront à fonctionner comme avant et vous n'avez rien à faire sur la partie page de paiement. Par contre, vous pouvez optimiser certains points : 

  • Utiliser un Content Delivery Network (CDN) pour l'intégration du script widget dans vos pages de paiements 
  • Implétementer la bascule à la source sur les appels webservice doWebPayment et getWebPaymentDetails effectués depuis votre serveur vers les serveurs Payline (voir https://docs.monext.fr/x/45BoLQ).


Optimisation des traitements 

Néanmoins, il existe deux optimisations qu'un commerçant peut mettre en oeuvre pour améliorer la fluidité des achats :

  1. Si le commerçant utilise le widget, alors celui-ci doit récupérer le widget (fichier JS et CSS) sur un CDN (Content Delivery Network), ce qui garantie la disponibilité du fichier, même si Monext n'est pas accessible.
  2. Choisir pour chaque paiement,  le meilleur endpoint pour le getWebPaymentDetail, c'est à dire celui où a été effectivement effectué le paiement.


Récupération du widget sur un CDN

Facultatif pour un commerçant ayant déjà intégré Payline. A terme, l'URL du payment.payline.com sera basculée sur un CDN

De manière à renforcer encore la disponibilité du widget, le commerçant peut récupérer le widget sur une URLs d'un CDN.

Les URLs à utiliser sont les suivantes :

Environnement

URL Widget

URL CSS

Homologation
https://homologation-payment.cdn.payline.com/cdn/scripts/widget-min.js
https://homologation-payment.cdn.payline.com/cdn/styles/widget-min.css
Production
https://payment.cdn.payline.com/cdn/scripts/widget-min.js
https://payment.cdn.payline.com/cdn/styles/widget-min.css


Dans ce cas, l’intégration du widget dans vos pages doit être changé de cette manière :


<link rel="stylesheet" href="https://homologation-payment.payline.com/styles/widget-min.css" charset="utf-8">
<script src="https://homologation-payment.payline.com/scripts/widget-min.js" charset="utf-8"></script>


<link rel="stylesheet" href="https://homologation-payment.cdn.payline.com/styles/widget-min.css" charset="utf-8">
<script src="https://payment.cdn.payline.com/scripts/widget-min.js"></script>
<!-- Permet un récupération directe sur les serveurs de Payline en cas de défaillance du CDN -->
<script>window.Payline || document.write('<script src="https://payment.payline.com/scripts/widget-min.js"></script>')</script>


Implémentation de la bascule à la source sur les appels webservice doWebPayment et getWebPaymentDetail

Pour optimiser encore les bénéfices apportés par la bascule à la source, il est également possible d'implémenter ce mécanisme sur les appels webservices réalisés avant et après l'étape de paiement. 

Deux méthodes sont concernées : 

  • doWebPayment
  • getWebPaymentDetails

Les explications sont disponibles sur la rubrique https://docs.monext.fr/x/45BoLQ


Optimisation de l'appel au getWebPaymentDetail

Facultatif pour les commerçants. Cette fonction permet une meilleure expérience utilisateur mais n'est pas requise.

L'obtention plus rapide du résultat du paiement peut être fait en appelant le getWebPaymentDetail sur  le même endpoint que celui sur lequel a été réalisé le paiement.

Les URLs "returnURL", "CancelURL" et "NotifURL" contiennent un paramètre indiquant le endpoint sur lequel le a été effectué le paiement. Ce paramètre est paymentEndpoint

Paramètre

Format

Commentaire

paymentEndpointInteger, commence à 1La valeur de ce paramètre correspond à l'index du endpoint dans le service d'annuaire.