Tokenisation client
La tokenisation du client revient à ajouter Sezzle comme mode de paiement enregistré auprès du commerçant, permettant ainsi au commerçant d'utiliser Sezzle comme mode de paiement pour les commandes futures (sans interaction avec le client). Les abonnements sont l’un des principaux cas d’utilisation de la tokenisation client. Par exemple, un commerçant peut choisir de tokeniser un client afin de facturer par Sezzle sur une base semestrielle.
Un processus typique de tokenisation d'un client dans Sezzle pourrait être le suivant : un utilisateur est connecté au site marchand et l'utilisateur souhaite ajouter Sezzle comme mode de paiement stocké. Le commerçant peut démarrer une session avec Sezzle et attribuer l'UUID de session à l'utilisateur connu. Le commerçant redirigera l'utilisateur vers Sezzle et l'utilisateur pourra accepter la tokenisation. Une fois que l'utilisateur a accepté, Sezzle redirigera l'utilisateur vers le site marchand et ajoutera également un UUID client unique à l'URL du marchand, permettant ainsi au commerçant d'attribuer cet UUID client à l'utilisateur qui a démarré la session. L'UUID client peut désormais être utilisé pour créer une commande par client directement avec Sezzle. Les commandes créées par le client sont traitées de la même manière que les commandes créées en effectuant un paiement Sezzle.
La tokenisation n'est pas obligatoire et n'est nécessaire que si le commerçant a besoin de facturer par Sezzle en dehors d'un processus de paiement typique. Sezzle recommande la tokenisation selon les besoins.
- Le commerçant démarre une session en appelant
/v2/session
avec un jeton clienttrue
. L'inclusion des informations client est facultative, mais cela peut accélérer le processus d'inscription pour les nouveaux utilisateurs de Sezzle. - Sezzle renvoie le jeton
tokenize
de session et une URL d'approbation. - Le marchand redirige le client vers l'URL d'approbation Sezzle.
- Le client peut accepter (ou refuser) d'autoriser les futures transactions Sezzle du commerçant et est redirigé vers l'URL complète de la session. Si le client accepte d'être tokenisé, Sezzle ajoutera un paramètre de requête à l'URL complète nommé
customer-uuid
, permettant au commerçant d'obtenir l'UUID du client. Alternativement, le commerçant peut appeler/v2/token
avec la session « tokenize.token » pour obtenir l'UUID du client. - Le marchand peut ensuite facturer le client en appelant
/v2/customer/{customer_uuid}/order
pour créer une commande. En cas de succès et que l'autorisation est approuvée, le commerçant peut utiliser les points de terminaison « /v2/order » pour libérer, capturer ou rembourser la commande.
Le commerçant a également la possibilité de créer une commande et de tokeniser le client en une seule session. Dans ce cas, le commerçant doit rediriger le client vers l’URL de paiement de la commande. Lors du paiement, le client peut accepter d'autoriser les futures transactions Sezzle par le commerçant (c'est-à-dire accepter la tokenisation). Si le client accepte d'être tokenisé, Sezzle ajoutera un paramètre de requête à l'URL complète nommé customer-uuid
.
Remarque: Sezzle renvoie à la fois une URL de paiement et une URL d'approbation lors d'une session de création qui inclut à la fois la tokenisation et une commande. Si le client n'accepte pas d'être tokenisé lors du paiement, le commerçant peut utiliser l'URL d'approbation ultérieurement.
Clients
Utilisez les points de terminaison des clients pour obtenir une liste de clients, obtenir des détails sur un client existant, supprimer un client, pré-approuver un montant pour le client ou créer une commande pour un client.
Les clients sont uniquement les utilisateurs de Sezzle qui ont accepté d'être tokenisés par le commerçant. Un client est unique pour un commerçant. Cette API n'inclut pas tous les utilisateurs de Sezzle.