> ## 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.
# SDK mobiles
Intégrez Sezzle directement dans vos applications natives iOS et Android. Les SDK mobiles Sezzle offrent deux fonctionnalités principales :
1. **Messagerie promotionnelle** — widgets prêts à l'emploi qui affichent la tarification en versements sur les pages produit
2. **Paiement** — lancez une session de paiement Sezzle depuis votre application et gérez le résultat
Swift Package Manager, CocoaPods. iOS 15+.
Maven Central, Gradle. Android 6.0+ (API 23).
## Fonctionnement
```mermaid theme={"system"}
sequenceDiagram
participant App as Merchant App
participant SDK as Sezzle SDK
participant API as Sezzle API
participant Browser as Browser / WebView
App->>SDK: 1. Configure (public key)
App->>SDK: 2. Show promotional widget (price)
SDK-->>App: Renders installment messaging
App->>SDK: 3. Start checkout (order details)
SDK->>API: POST /v2/session
API-->>SDK: Session + checkout URL
SDK->>Browser: 4. Open checkout
Browser-->>SDK: 5. Customer completes / cancels
SDK-->>App: 6. Callback (order UUID)
App->>API: 7. Capture payment (server-side)
```
**Intégration pilotée par le serveur ?** Si vous préférez ne pas stocker votre clé publique sur l'appareil et laisser votre backend créer la session Sezzle directement, le SDK expose également une surcharge pass-URL `startCheckout` overload (`1.2.0`+). Votre serveur crée la session, votre application transmet l'URL résultante `checkout_url` au SDK, et le SDK renvoie le résultat via le même délégué. Consultez la section **Intégration pilotée par le serveur** dans le guide [iOS](/fr/docs/guides/mobile/ios#8-server-driven-integration) ou [Android](/fr/docs/guides/mobile/android#8-server-driven-integration).
## Modes de paiement
Le SDK prend en charge deux façons de présenter le paiement Sezzle :
| | Navigateur système | WebView |
| -------------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| **Mode d'ouverture** | iOS: `ASWebAuthenticationSession` / Android : Chrome Custom Tab | WKWebView intégré à l'application / Android WebView |
| **Recommandé** | Oui (par défaut) | Opt-in |
| **Sécurité** | S'exécute dans un processus de navigateur séparé | S'exécute dans le processus de votre application |
| **Partage de cookies** | Partage les cookies avec Safari/Chrome (connexion plus rapide pour les utilisateurs Sezzle existants) | Pas de partage de cookies |
| **Expérience utilisateur** | Bref changement de contexte vers le navigateur | Reste dans votre application |
## Messagerie promotionnelle
Le SDK inclut un widget promotionnel prêt à l'emploi qui affiche automatiquement le bon message de versements en fonction du prix du produit :
| Plage de prix | Message |
| -------------------------------------------------------------- | ----------------------------------------------------------- |
| En dessous du minimum (35 \$ par défaut) | Widget masqué |
| $35 -- $49.99 | "ou 4 paiements de X,XX \$ avec Sezzle" |
| $50 -- $2,500 | "ou 5 paiements de X,XX \$ avec Sezzle" |
| Au-dessus du maximum à court terme (avec le long terme activé) | "ou des paiements mensuels à partir de X,XX \$ avec Sezzle" |
Appuyer sur le widget ouvre une fenêtre modale éducative affichant le calendrier de paiement complet :
## Mode sombre
Les deux SDK s'adaptent automatiquement au paramètre d'apparence de l'appareil. Le widget promotionnel, la fenêtre modale de versements et toutes les couleurs de marque s'ajustent pour les modes clair et sombre.
## Prérequis
Avant de commencer, assurez-vous d'avoir :
1. Un compte marchand Sezzle — inscrivez-vous ici si vous n'en avez pas
2. Votre Clé API publique depuis le tableau de bord marchand Sezzle
3. Un serveur backend capable d'appeler l'API Sezzle pour capturer les paiements après le paiement
Le SDK utilise uniquement votre clé API **publique**. Votre clé privée reste sur votre serveur et est utilisée pour capturer les paiements une fois que le client a finalisé son paiement.
## Code source
Les deux SDK sont open source sur GitHub :
* sezzle/sezzle-merchant-sdk-ios
* sezzle/sezzle-merchant-sdk-android