> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sezzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aperçu v1

<Danger>
  Vous consultez la version 1 de l'API Sezzle. Découvrez la [version actuelle](/fr/docs/api/intro)!
</Danger>

* L'API Sezzle v1 est conçue pour les marchands souhaitant accepter Sezzle comme option de paiement.
* Le [Flux d'intégration](#integration-flow) 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 requis pour commencer l'intégration ; visitez la [page d'inscription](https://dashboard.sezzle.com/merchant/signup) pour en créer un si nécessaire.

## Tests

Pendant que vous travaillez sur l'intégration, vous devez la tester dans un environnement sandbox avant de passer en production.

### Sandbox

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

<Note>
  Les identifiants de connexion au tableau de bord sandbox sont les mêmes que ceux utilisés pour se connecter au tableau de bord marchand Sezzle. Vous pouvez créer vos clés API de test dans le [tableau de bord sandbox](https://sandbox.dashboard.sezzle.com/merchant/settings/apikeys).
</Note>

### Données de test

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

| Banque      | Nom d'utilisateur | Mot de passe |
| ----------- | ----------------- | ------------ |
| `Test Bank` | `demo`            | `go`         |

| Numéro de carte    | CVV/CVC           | Date d'expiration | Nom   | Adresse |
| ------------------ | ----------------- | ----------------- | ----- | ------- |
| `4242424242424242` | `any (3 numbers)` | `any`             | `any` | `any`   |

### Téléphone et autres informations

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

## Flux d'intégration

<Frame>
  <img src="https://mintcdn.com/sezzle/hKhvshWly4M3cXTJ/images/docs/api/Group3.png?fit=max&auto=format&n=hKhvshWly4M3cXTJ&q=85&s=8938e6b1405165ddceca38e9510d243c" alt="Api Flow Pn" width="7488" height="5376" data-path="images/docs/api/Group3.png" />
</Frame>

### Explication du flux de paiement

1. Le marchand appelle `/v1/checkouts` pour envoyer les données du panier à Sezzle
2. Sezzle retourne l'URL pour rediriger le consommateur afin d'effectuer le paiement sur la page de paiement Sezzle
3. Le marchand redirige le consommateur vers Sezzle
4. Lorsque le consommateur termine le processus de paiement Sezzle, il est redirigé vers le site Web du marchand
5. Alternativement, lors de l'approbation, le consommateur est redirigé de la page de paiement Sezzle vers le site Web du marchand et le marchand capture la commande en appelant`/v1/complete`

### Demande de remboursement

| Paramètre        | Type    | Description                                                                                                                                                                                                                                                                                          |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `amount*`        | object  | Un objet de 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`is_full_refund` paramètre est true. |
| `refund_id`      | string  | UUID pour le remboursement. Doit être unique à un marchand.                                                                                                                                                                                                                                          |
| `refund_reason`  | string  | Une raison pour le remboursement.                                                                                                                                                                                                                                                                    |
| `is_full_refund` | boolean | Remplace`amount`.  Si true, la commande sera entièrement remboursée. Si omis, la valeur par défaut sera false                                                                                                                                                                                        |

## Javascript SDK

Le Javascript SDK est documenté dans la dernière[documentation API v2](/#javascript-sdk). Il est pris en charge pour les utilisateurs de l'API v1 utilisant le même script de page chargeable.

<Note>
  Lors de l'utilisation du Javascript SDK avec v1, utilisez apiVersion: "v1" dans le constructeur Checkout.
</Note>

### Créer un Checkout

```javascript theme={"system"}
checkout.startCheckout({
    checkout_payload: {
        "amount_in_cents": 12999,
        "currency_code": "USD",
        "order_reference_id": "Ref123456789",
        "order_description": "Order #1800",
    }
});
```

* Utilisation du Javascript SDK avec v1 :
  * Créez un checkout avec l'objet Checkout.
  * Complétez le checkout en utilisant le point de terminaison Compléter un Checkout.
* 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 indiqué dans l'exemple de capture pour v1.

### Compléter un Checkout

```javascript theme={"system"}
checkout.capturePayment("Ref123456789");
```

## SDK Widget de messagerie sur site

* Le SDK Widget de messagerie sur site charge les widgets promotionnels 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](https://github.com/sezzle/sezzle-js).
* Consultez la dernière documentation pour les détails de configuration des widgets.
