Prérequis
- Un compte Paddle (gratuit à créer)
Obtenez votre clé API Paddle
- Connectez-vous à votre tableau de bord Paddle
- Allez dans Outils développeur → Authentification
- Cliquez sur Générer une clé API
- Copiez la clé — elle commence par
pdl_live_
Tester d’abord ? Utilisez le tableau de bord Sandbox à la place. Les clés sandbox commencent par
pdl_test_ et aucune somme réelle n’est débitée.Connecter Paddle à Komerza
- Dans votre tableau de bord Komerza, allez dans Méthodes de paiement
- Trouvez Paddle et cliquez sur Configurer
- Collez votre Clé API (de l’Étape 1)
- Cliquez sur Enregistrer
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
Si le statut est Inactif, vérifiez que votre clé API commence par
pdl_live_ (ou pdl_test_ pour le sandbox).Comment ça fonctionne
- Un client sélectionne Paddle lors du paiement
- Il est redirigé vers la page de paiement sécurisée hébergée par Paddle
- Après le paiement, il est renvoyé à votre boutique avec une confirmation
- 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 :- Créez un compte Sandbox
- Utilisez votre clé API sandbox (
pdl_test_...) - Aucune charge réelle n’est effectuée — vous pouvez tester le flux complet en toute sécurité
- 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) |