Prérequis
- Un compte Paddle (gratuit à créer)
1
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.2
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
3
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