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.


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, 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>


Optimisation de l'appel au getWebPaymentDetail

Facultatif pour les commerçants. Cette fonction permet une meilleure UX 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.