Vous consultez la Version 1 de l’API Sezzle. Consultez la version actuelle!

  • L’API Sezzle v1 est conçue pour les marchands souhaitant accepter Sezzle comme option de paiement.
  • Le Flux d’intégration décrit le processus d’interaction de paiement de l’utilisateur.
  • Sezzle prend en charge les transactions autorisées individuellement pour les achats uniques de biens ou de services.
  • Un compte Sezzle approuvé est nécessaire pour commencer l’intégration; visitez la page d’inscription pour en créer un si nécessaire.

Tests

Pendant que vous travaillez sur l’intégration, vous devriez la tester dans un environnement sandbox avant de la mettre en production.

Sandbox

Point de terminaison API https://sandbox.gateway.sezzle.com/v1
Tableau de bord Sandbox https://sandbox.dashboard.sezzle.com/merchant

Les identifiants pour se connecter au tableau de bord sandbox sont les mêmes que ceux que vous utilisez pour vous connecter au Tableau de bord Marchand Sezzle. Vous pouvez créer vos clés API de test dans le tableau de bord sandbox.

Données de test

Vous pouvez utiliser les données de test suivantes pour tester votre intégration:

BanqueNom d’utilisateurMot de passe
Test Bankdemogo
Numéro de carteCVV/CVCDate d’expirationNomAdresse
4242424242424242any (3 numbers)anyanyany

Téléphone et autres informations

  • Veuillez utiliser n’importe quel numéro de téléphone valide
  • Le OTP attendu est 123123
  • Les informations personnelles n’ont pas besoin d’être réelles

Spécification Open API

  • La Spécification OpenAPI (OAS) offre une interface standard, indépendante du langage pour les API RESTful, permettant aux humains et aux machines de comprendre les capacités du service sans code source, documentation ou analyse du trafic réseau.
  • Accédez à la Spécification OpenAPI Sezzle v2 pour les détails d’intégration.
  • Importez la Spécification OpenAPI Sezzle v2 dans l’Éditeur Swagger pour générer un client Sezzle dans plusieurs langages de programmation.
  • Pour les langages non pris en charge par Swagger, utilisez OpenAPI Generator comme outil alternatif.

Flux d’intégration

Api Flow Pn

Explication du flux de paiement

  1. Le marchand appelle /v1/checkouts pour envoyer les données du panier à Sezzle
  2. Sezzle renvoie l’URL pour rediriger le consommateur vers le paiement à la caisse Sezzle
  3. Le marchand redirige le consommateur vers Sezzle
  4. Lorsque le consommateur termine le flux de paiement Sezzle, il est redirigé vers le site web du marchand
  5. Alternativement, lors de l’approbation, le consommateur est redirigé de la caisse Sezzle vers le site web du marchand et le marchand capture la commande en appelant /v1/complete

Demande de remboursement

ParamètreTypeDescription
amount*objectUn objet prix qui définit le montant à rembourser. Le montant ne peut pas être 0, négatif ou dépasser le montant total de la commande. La devise doit être soit la devise de la commande, soit la devise de paiement du client. Ce champ est facultatif si le paramètre is_full_refund est vrai.
refund_idstringUUID pour le remboursement. Doit être unique pour un marchand.
refund_reasonstringUne raison pour le remboursement.
is_full_refundbooleanRemplace amount. Si vrai, la commande sera entièrement remboursée. Si omis, la valeur par défaut sera false

SDK Javascript

Le SDK Javascript est documenté dans la dernière documentation de l’API v2. Il est pris en charge pour les utilisateurs de l’API v1 utilisant le même script de page chargeable.

Lors de l’utilisation du SDK Javascript avec v1, utilisez apiVersion: “v1” dans le constructeur Checkout.

Créer un paiement

checkout.startCheckout({
    checkout_payload: {
        "amount_in_cents": 12999,
        "currency_code": "USD",
        "order_reference_id": "Ref123456789",
        "order_description": "Order #1800",
    }
});
  • Utilisation du SDK Javascript avec v1:
    • Créez un paiement avec l’objet Checkout.
    • Complétez le paiement en utilisant le point de terminaison Compléter un paiement.
  • Le point de terminaison v1:
    • Capture le montant total de la commande.
    • Ne nécessite pas de corps de requête.
  • N’utilisez pas l’objet payload montré dans l’exemple de capture pour v1.

Compléter un paiement

checkout.capturePayment("Ref123456789");

SDK Widget

  • Le SDK Widget charge les widgets de vente Sezzle sur les pages web.
  • Les widgets nécessitent qu’une configuration soit fournie avant le chargement du script, sinon ils ne s’afficheront pas.
  • Le dépôt du projet est disponible sur https://github.com/sezzle/sezzle-js.
  • Consultez la documentation la plus récente pour les détails de configuration des widgets.