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

# Configurer Paddle

> Configurer les paiements Paddle sur votre boutique Komerza

Acceptez les paiements via Paddle sur votre boutique Komerza. Paddle gère l'interface de paiement — vos clients sont redirigés vers une page de paiement sécurisée hébergée par Paddle, puis renvoyés à votre boutique une fois le paiement effectué.

## Prérequis

* Un [compte Paddle](https://www.paddle.com/) (gratuit à créer)

<Steps>
  <Step title="Obtenez votre clé API Paddle">
    1. Connectez-vous à votre [tableau de bord Paddle](https://vendors.paddle.com/)
    2. Allez dans **Outils développeur → Authentification**
    3. Cliquez sur **Générer une clé API**
    4. Copiez la clé — elle commence par `pdl_live_`

    <Note>
      **Tester d'abord ?** Utilisez le [tableau de bord Sandbox](https://sandbox-vendors.paddle.com/) à la place. Les clés sandbox commencent par `pdl_test_` et aucune somme réelle n'est débitée.
    </Note>
  </Step>

  <Step title="Connecter Paddle à Komerza">
    1. Dans votre tableau de bord Komerza, allez dans **Méthodes de paiement**
    2. Trouvez **Paddle** et cliquez sur **Configurer**
    3. Collez votre **Clé API** (de l'Étape 1)
    4. Cliquez sur **Enregistrer**

    Komerza crée automatiquement l'endpoint webhook sur votre compte Paddle. Aucune configuration manuelle du webhook n'est nécessaire.
  </Step>

  <Step title="Vérifier la connexion">
    Allez dans **Méthodes de paiement → Paddle** dans votre tableau de bord. Le statut affichera :

    * **Actif** — Tout est connecté et fonctionne
    * **Inactif** — Vérifiez que votre clé API est correcte

    <Note>
      Si le statut est **Inactif**, vérifiez que votre clé API commence par `pdl_live_` (ou `pdl_test_` pour le sandbox).
    </Note>
  </Step>
</Steps>

## Comment ça fonctionne

1. Un client sélectionne Paddle lors du paiement
2. Il est redirigé vers la page de paiement sécurisée hébergée par Paddle
3. Après le paiement, il est renvoyé à votre boutique avec une confirmation
4. Komerza reçoit un webhook de Paddle confirmant le paiement et livre la commande automatiquement

## Gestion des paiements

* **Remboursements** — Vous pouvez émettre des remboursements complets via Komerza. Le remboursement est traité par le système Paddle et le client est crédité.
* **Litiges** — Si un client ouvre un litige avec sa banque, vous recevrez une notification dans Komerza. La commande est marquée comme litigieuse et vous pouvez répondre via le tableau de bord Paddle.

## Tests sandbox

Si vous souhaitez tester avant de passer en production :

1. Créez un [compte Sandbox](https://sandbox-vendors.paddle.com/)
2. Utilisez votre clé API sandbox (`pdl_test_...`)
3. Aucune charge réelle n'est effectuée — vous pouvez tester le flux complet en toute sécurité
4. Lorsque vous êtes prêt, déconnectez et reconnectez avec votre clé API de production

## Déconnecter Paddle

Allez dans **Méthodes de paiement → Paddle** et cliquez sur **Déconnecter**. Cela supprime également l'endpoint webhook de votre compte Paddle. Vos commandes existantes ne sont pas affectées — seuls les nouveaux paiements n'offriront plus Paddle.

## Dépannage

| Problème                            | Solution                                                                                          |
| ----------------------------------- | ------------------------------------------------------------------------------------------------- |
| Les paiements ne se complètent pas  | Vérifiez que votre clé API est valide et commence par `pdl_live_` (ou `pdl_test_` pour sandbox)   |
| Statut inactif                      | Vérifiez votre clé API dans **Méthodes de paiement → Paddle**                                     |
| Notifications de litiges non reçues | Contactez le support — le webhook devra peut-être être recréé (déconnectez et reconnectez Paddle) |