Intégration du passage à la caisse

Cette section décrit l'intégration de Paysafe Checkout. Quelques lignes de code suffisent pour intégrer le passage à la caisse et commencer à percevoir des paiements.

La caisse permet de traiter et stocker en toute sécurité toutes les informations relatives au paiement, comme les données saisies par l'utilisateur (carte de crédit et coordonnées bancaires) et vous renvoie les informations de paiement sous forme de jetons.

Elle fonctionne avec les API de paiements Paysafe et les informations sur la structure de la requête, les objets et les variables sont disponibles dans la référence API.

• Avant de commencer

• Inclure des scripts dans votre page Web

• Initier le passage à la caisse

Connectez-vous au portail d'entreprise pour obtenir votre clé d'API publique. Veuillez contacter votre responsable des relations avec les entreprises ou vous adresser à integrations@paysafe.com pour obtenir vos authentifants au portail d’entreprise.

Pour en savoir plus sur cette procédure, voir Obtenir des clés publiques. 

Paysafe Checkout recueille les coordonnées de vos clients, comme les informations sur le compte, les données de facturation, etc. Il aide vos clients à finaliser leur commande en traitant les paiements. La trousse de développement logiciel de Paysafe Checkout vous donne la liberté de créer votre intégration personnalisée. 

Contactez notre équipe dédiée à l'aide à l'intégration à l'adresse integrations@paysafe.com pour créer un compte de test, et indiquez les paiements pris en charge que vous souhaitez ajouter à votre compte de test.

Comment utiliser la SDK

1. Incluez la SDK Paysafe Checkout dans votre formulaire de paiement HTML.

2. Appelez la fonction de configuration de la caisse avec votre clé d'API publique.

3. Le rappel utilise AJAX pour envoyer le jeton de "payment handle" (contenant les détails de paiement du client) à votre site Web (marchand), où vous pouvez écrire votre propre logique pour envoyer ce jeton à votre serveur (marchand) afin d'effectuer un paiement ou de traiter un paiement à l'aide de l'API de paiements Paysafe.

Inclure la SDK

La SDK se trouve ici :

https://hosted.paysafe.com/checkout/v2/paysafe.checkout.min.js

Vous devez l'inclure dans votre formulaire HTML en ajoutant un élément <script> dans l'en-tête ou le corps du formulaire. 

La fonction de configuration crée une superposition « iframe » contenant le formulaire de paiement/formulaire de retraite hébergé sur les serveurs de Paysafe. Vous devrez passer une fonction de rappel dans le cadre de la configuration pour gérer la réussie ou l’échec des paiements. Elle comporte les paramètres suivants :

• La version encodée en Base64 de la clé API

• Un objet options contenant l'environnement à utiliser (Test ou Direct), le montant du paiement, la devise et plusieurs paramètres permettant de personnaliser le formulaire de paiement et d'en adapter l'apparence.

• Un resultCallback qui reçoit l'instance Paysafe Checkout et gère la tokenisation (en envoyant le jeton à votre serveur de marchand). Elle répond également aux erreurs provoquées par l'échec de tokenisation.

• Une fonction facultative closeCallback pour gérer la fermeture de la superposition de paiement par le client.

• Une fonction facultative riskCallback pour recevoir le montant et le mode de paiement que le client a sélectionnés et exécuter vos contrôles de risque avant que le "payment handle" ne soit créé. En fonction de la réponse de riskCallback, un "payment handle" sera créé et renvoyé dans resultCallback (applicable uniquement aux cartes, PaySafe Cash, VIPP et Sightline).

La signature de la fonction est la suivante :

<paysafe.checkout.setup(apikey, options,resultsCallback, closeCallback, riskCallback);>