Documentation Monext Online

Arborescence des pages

Comparaison des versions

Ancienne version 2

changes.mady.by.user Rodolphe GARIN

Sauvegardée le

comparé à

Nouvelle version Actuel

changes.mady.by.user Mathieu BRISEBARRE

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: modification lien

Contenu 

Sommaire
maxLevel2
stylenone

Plus d'information

Page Tree
rootBascule à la source

Extrait
hiddentrue

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


Intégration

avec API WebPayment

Les modes

Le mode 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.

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.

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 

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 formulaire de paiement intégré (widget), le commerçant peut récupérer le widget sur une URLs 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


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

Bloc de code
languagexml
themeEclipse
titleRé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 : 

Bloc de code
languagexml
themeEclipse
titleRé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>


Info
titleURL à 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 UX 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.