Documentation Monext Online

Arborescence des pages

Comparaison des versions

Ancienne version 6

changes.mady.by.user Mathieu BRISEBARRE

Sauvegardée le

comparé à

Nouvelle version 7

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.

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 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 depuis les navigateurs acheteursautomatiquement.

Par contre, vous pouvez optimiser certains points : 

  • Action 1  - Utiliser un 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 (voir https://docs.monext.fr/x/45BoLQ)
  • Action 3 - Optimisation de Optimiser l'appel au getWebPaymentDetails si le paiement a été effectué sur un autre site que le nominal

Optimisation des traitements 

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

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.
  • Choisir pour chaque paiement,  le meilleur endpoint pour le getWebPaymentDetail, c'est à dire celui où a été effectivement effectué le paiement.


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

    CDN

    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 (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 https://docs.monext.fr/x/45BoLQBascule à la source - 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.