L'add-on Passerelle de paiement Paddle accepte les paiements via la plateforme de marchand de référence de Paddle — les clients paient via un overlay de paiement intégré propulsé par Paddle.js v2, tandis que Paddle gère la conformité fiscale, la facturation et les méthodes de paiement internationales dans plus de 200 pays.
Tarification : Ceci est un add-on payant, disponible sur le Marketplace Larapen.
Fonctionnalités principales
- Overlay de paiement Paddle.js v2 — Les clients paient via l'overlay intégré de Paddle directement sur votre site. Pas de redirection hors de votre page de paiement. Supporte cartes bancaires, PayPal, Apple Pay, Google Pay et méthodes de paiement locales.
- Marchand de référence — Paddle agit en tant que marchand de référence, gérant la collecte et la conformité de la TVA/taxe de vente dans le monde entier. Vous recevez des versements nets.
- Confirmation par webhooks — Les mises à jour de statut de commande sont confirmées via des webhooks signés (HMAC-SHA256) pour un traitement fiable des paiements, même si le client ferme son navigateur.
- Support des remboursements — Traitez les remboursements totaux ou partiels directement depuis le panneau d'administration via l'API Adjustments de Paddle. Les statuts de remboursement (approuvé, en attente, refusé) sont suivis automatiquement.
- Identifiants chiffrés — La clé API, le jeton côté client et le secret du webhook sont chiffrés au repos via
Crypt::encryptString()de Laravel. Jamais stockés en clair. - Sandbox et production — Basculez entre les environnements sandbox et production de Paddle depuis le panneau d'administration. Les jetons sandbox commencent par
test_, les jetons live parlive_. - Liaison des clients — Stocke les identifiants clients Paddle liés aux comptes utilisateurs pour les achats répétés.
- Contrat de passerelle de paiement — Implémente le
PaymentGatewayInterfacede Larapen, s'intégrant de manière transparente au flux de paiement de la Boutique.
Panneau d'administration
| Section | Description |
|---|---|
| Paramètres | Configurer la clé API Paddle, le jeton côté client, le secret du webhook, l'ID vendeur, l'environnement (sandbox/production) et la devise. Tous les identifiants sensibles sont stockés chiffrés. |
Flux de paiement
- Le client sélectionne « Paddle » lors du paiement. Un message d'information apparaît.
- Le formulaire est soumis via AJAX. Le serveur crée une transaction Paddle via l'API.
- L'overlay Paddle.js s'ouvre avec
Paddle.Checkout.open()en utilisant l'ID de transaction. - Le client finalise le paiement dans l'overlay (cartes, PayPal, Apple Pay, etc.).
- À la fin du paiement (
checkout.completed), le client est redirigé vers l'URL de retour pour confirmation. - Paddle envoie également un webhook
transaction.completedcomme confirmation de secours fiable.
Événements webhook
| Événement | Action |
|---|---|
transaction.completed | Marque la commande comme payée et crée un enregistrement de transaction boutique. |
transaction.payment_failed | Marque le paiement comme échoué avec le code d'erreur. |
adjustment.created | Met à jour le statut de commande en remboursé si l'ajustement est un remboursement approuvé. |
adjustment.updated | Même traitement que adjustment.created pour les changements de statut de remboursement. |
Configuration
| Paramètre | Description |
|---|---|
| Clé API | Clé API Paddle pour les appels API côté serveur (transactions, remboursements). Stockée chiffrée. |
| Jeton côté client | Jeton pour initialiser Paddle.js sur le frontend. Les jetons sandbox commencent par test_. Stocké chiffré. |
| Secret du webhook | Clé secrète pour vérifier les signatures des webhooks Paddle (HMAC-SHA256). Stocké chiffré. |
| ID vendeur | Votre ID vendeur Paddle. Requis pour l'initialisation de Paddle.js. |
| Environnement | sandbox pour les tests ou production pour les paiements en direct. |
| Devise | Code devise (ex. USD, EUR, GBP). Doit correspondre à la devise de votre boutique. |
Dépendances
Requis : L'add-on E-Shop doit être installé et actif. L'add-on Paddle s'enregistre comme passerelle de paiement via le contrat PaymentGatewayInterface et est automatiquement découvert par le système de paiement de la boutique. Le package Composer paddle/paddle-php-sdk est requis.
Guide de configuration
- Installez et activez d'abord l'add-on E-Shop.
- Installez le SDK PHP Paddle :
composer require paddle/paddle-php-sdk. - Installez et activez l'add-on Paddle.
- Allez dans Paddle > Paramètres dans le panneau d'administration.
- Saisissez votre clé API, jeton côté client et ID vendeur depuis le Tableau de bord Paddle.
- Créez un webhook dans le tableau de bord Paddle pointant vers
https://votresite.com/paddle/webhooket saisissez le secret du webhook. - Paddle apparaîtra comme option de paiement lors du passage en caisse.
Idéal pour
- Entreprises SaaS et vendeurs de produits numériques souhaitant une conformité fiscale automatisée.
- Sites e-commerce internationaux nécessitant un support multi-devises avec gestion automatique de la TVA.
- Entreprises souhaitant une solution de marchand de référence qui simplifie la vente internationale.
- Sites vendant à des clients européens nécessitant une conformité TVA MOSS automatisée.