Documentation Monext Online

Arborescence des pages

Contenu 

Plus d'information

Intégration

Les modes d'intégration "formulaire intégré" 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 sur le navigateur de l'acheteur, il sera effectué une tentative sur le endpoint suivant automatiquement.

Par contre, vous pouvez optimiser certains points : 

  • Action 1  - Utiliser le Content Delivery Network (CDN) fournis par Monext pour l'intégration du script widget dans vos pages de paiements 
  • Action 2 - Implémenter la bascule à la source sur les appels webservice doWebPayment et getWebPaymentDetails effectués depuis votre serveur vers les serveurs Payline
  • Action 3 - Optimiser l'appel au getWebPaymentDetails si le paiement a été effectué sur un autre site que le nominal


Action 1 - Récupération du widget sur un CDN 

De manière à renforcer encore la disponibilité du formulaire de paiement intégré (widget), le commerçant peut récupérer le widget sur une URL 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


SI ce n'est pas encore le cas, l’intégration du widget dans vos pages est actuellement effectuée de cette manière :

Récupération directe sur les serveurs Payline
<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>

A remplacer par ce code afin de bénéficier du CDN : 

Récupération du widget sécurisée à travers un CDN
<link rel="stylesheet" href="https://homologation-payment.cdn.payline.com/cdn/styles/widget-min.css" charset="utf-8">
<script src="https://homologation-payment.cdn.payline.com/cdn/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://homologation-payment.payline.com/scripts/widget-min.js"></script>')</script>

URL à remplacer dans le cas de la production

Dans cet exemple, il faudra remplacer les URL d'homologation par les URL de production (astuce : retirer "homologation-" de chaque URL)

Action 2 - 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 depuis les serveurs du marchand. 

Deux méthodes sont concernées : 

  • doWebPayment
  • getWebPaymentDetails

Les explications sont disponibles sur la rubrique Guide d'intégration sur les appels API Webservices

Ce point est crucial pour l'amélioration de la disponibilité du service mais demande des modifications côté serveur marchand : 

  • développements à réaliser si l'intégration a été effectuée par le marchand lui même
  • ou utilisation de la dernière version des kits Payline 

Action 3 - 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.