Integration
Le SDK JavaScript peut être utilisé pour une intégration simple et légère, mais il inclut également un mode en contexte qui hébergera le paiement Sezzle dans un iframe modal ou une fenêtre pop-up.
Paiements
Créez des paiements et capturez des paiements avec Sezzle.
Intégrations
Paiement dans un iframe, une fenêtre pop-up, ou redirection vers Sezzle.
Paiements
Gérez le succès, l’échec ou l’annulation du paiement avec vos commandes Sezzle.
Bouton Sezzle
Affichez le bouton de paiement Sezzle sur votre boutique.
Inclure le code SDK
Incluez le script suivant dans la<head>
section de la page.
Configuration du paiement
La première exigence pour commencer avec le SDK JavaScript direct est de configurer un nouvel objet Checkout.
Options de configuration
Options disponibles :popup
,iframe
,redirect
popupLe mode fonctionnera directement. Aucune configuration supplémentaire n’est requise pour utiliserpopup. Sezzle recommande actuellement le modepopup.iframeLe mode ne fonctionnera pas correctement sans contacter d’abord Sezzle. Pour des raisons de sécurité, Sezzle doit activeriframepour votre(vos) domaine(s). Pour l’activer, veuillez soumettre une demande avec votre UUID de marchand Sezzle et une liste des domaines à autoriser par environnement (production et sandbox). Par exemple,veuillez activer uat1.monsite.com, uat2.monsite.com dans sandbox et www.monsite.com, monsite.com en production. L’intégration pourpopupetiframesont identiques, à l’exception du mode. L’utilisation du modepopupaccélérera votre développement. Une fois l’intégration terminée, siiframeest une exigence, contactez alors Sezzle pour activer votre(vos) domaine(s) et passez le mode àiframe.
Utilisé lors de la création d’un paiement ou de la capture d’un paiement. Trouvez vos clés API surhttps://dashboard.sezzle.com/merchant/settings/apikeys
Environnement dans lequel le paiement doit être effectué
Options disponibles :live
,sandbox
Version du SDK de paiement Sezzle
Options disponibles :v2
Bouton Sezzle
Configuration du bouton Sezzle
Créez un élément de placeholder pour que le bouton Sezzle soit rendu sur la(les) page(s).
Texte à afficher à l’intérieur du bouton. Utilisez%%logo%%
dans le texte pour
afficher l’image Sezzle
Options disponibles :square
,semi-rounded
Classes personnalisées à appliquer
Espace négatif entre le haut du contenu et le bord du bouton
Espace négatif entre le bas du contenu et le bord du bouton
Espace négatif entre le côté gauche du contenu et le bord du bouton
Espace négatif entre le côté droit du contenu et le bord du bouton
Largeur du logo Sezzle dans le bouton
Position du logo Sezzle depuis le haut.
Position du logo Sezzle depuis le bas.
Position du logo Sezzle depuis la gauche.
Position du logo Sezzle depuis la droite.
Espacement entre les lettres du texte du modèle.
Largeur du bouton
Hauteur du bouton.
Rendre le bouton Sezzle
Nécessite d’avoir l’objetcheckout
créé ci-dessus pour rendre le bouton. AppelezrenderSezzleButton
en passant leid
de l’élément placeholder défini dans la Configuration du bouton, ci-dessus.
Initialiser le paiement
Gestionnaires d’événements
Le SDK nécessite les gestionnaires d’événements suivants qui peuvent être utilisés pour étendre les fonctionnalités de votre application.
Le bouton Sezzle est cliqué par l’utilisateur.
Voir la sectionInitialisation du paiementpour les options de charge utile.
Le paiement Sezzle est effectué avec succès. Un paiement Sezzle réussi déclenchera un événement vers le gestionnaireonComplete
. L’événement devrait inclure un objet de données avec des données pertinentes pour le paramètre d’entrée de début de paiement.
Le paiement Sezzle est annulé. Si l’utilisateur quitte le paiement Sezzle pour une raison quelconque, le gestionnaireonCancel
sera exécuté.
Le paiement Sezzle a échoué. S’il y a une erreur lors du chargement de la page de paiement Sezzle, le gestionnaireonFailure
sera exécuté.
Initialisation du paiement
Alternativement, commencez le paiement par URL :
Le début du paiement doit être implémenté dans le gestionnaire deonClick
paiement. Il existe deux méthodes pour héberger un paiement.
Utilisez une charge utile de paiement comme détaillé dans l’Objet de Session
- Les URLs d’annulation et de complétion ne sont pas requises pour les modes
iframe
etpopup
.
Utilisez une URL de paiement existante
- Le
mode
utilisé lors de la configuration du paiement SDK doit correspondre aucheckout_mode
lors de lacréation d’une session. - La fenêtre parent
origin
doit être fournie dans les urls d’annulation et de complétion lorsque lecheckout_mode
estiframe
oupopup
.
Tokenisation du clientCeci n’est pas pris en charge dans l’événementonComplete
. Pour recevoir un UUID client, abonnez-vous àcustomer.tokenized event.
Paiement terminé par Payload
Paiement terminé par URL
Capturer le paiement
La capture d’une commande n’est pas nécessaire si le CAPTURE
intent a été utilisé lors de la création du paiement.
La méthode de capture du paiement nécessite deux paramètres, le order_uuid
et le payload comme détaillé dans le Capture Amount By Order Object.
Le montant à capturer sur cette commande
Plan de paiement échelonné
Cette fonction fournira les détails des versements basés sur un montant en centimes. Un checkout existant peut être utilisé, ou un checkout
sans aucune configuration peut également être utilisé pour obtenir rapidement les détails des versements.