Add-on Passerelle de paiement PayPal

L'add-on Passerelle de paiement PayPal intègre l'API REST PayPal à votre boutique Larapen — les clients sont redirigés vers la page de paiement hébergée par PayPal pour finaliser le paiement, puis renvoyés vers votre site avec capture automatique, confirmation par webhook et support complet des remboursements.

Fonctionnalités principales

• API REST PayPal — Utilise l'API REST moderne de PayPal avec l'intent CAPTURE pour créer des commandes et capturer les paiements de manière sécurisée.
• Paiement par redirection — Les clients sont redirigés vers la page de paiement hébergée par PayPal pour se connecter et approuver le paiement, puis renvoyés vers votre site. Aucun formulaire de carte bancaire requis sur votre site.
• Double confirmation — Les paiements sont confirmés à la fois par la redirection de retour (immédiate) et par les webhooks (asynchrone), garantissant que les commandes sont marquées comme payées même si le client ferme son navigateur.
• Support des remboursements — Traitez les remboursements totaux ou partiels directement depuis le panneau d'administration. Les transactions de remboursement sont suivies automatiquement avec support des statuts en attente (eCheck) et terminé.
• Identifiants chiffrés — L'ID client, le secret client et l'ID du webhook sont chiffrés au repos via Crypt::encryptString() de Laravel. Jamais stockés en clair.
• Multi-devises — Supporte tout code devise ISO 4217 (USD, EUR, GBP, etc.) configuré dans le panneau d'administration.
• Personnalisation de la marque — Configurez le nom de marque affiché sur la page de paiement PayPal (max 127 caractères).
• Payables polymorphiques — Fonctionne avec tout modèle implémentant le contrat Payable, pas limité aux commandes de la boutique.
• Contrat de passerelle de paiement — Implémente le PaymentGatewayInterface de Larapen, s'intégrant de manière transparente au flux de paiement de la Boutique.

Panneau d'administration

Flux de paiement

1. Le client sélectionne « PayPal » lors du paiement.
2. La boutique crée une commande PayPal via l'API REST avec l'intent CAPTURE.
3. Le client est redirigé vers la page de paiement hébergée par PayPal pour se connecter et approuver.
4. Après approbation, PayPal redirige vers /paypal/return où le paiement est capturé.
5. La commande est marquée comme payée, un enregistrement de transaction est créé, et le client voit la page de succès.
6. PayPal envoie également un webhook PAYMENT.CAPTURE.COMPLETED comme confirmation de secours fiable.

Événements webhook

Configuration

Dépendances

Requis : L'add-on E-Shop doit être installé et actif. L'add-on PayPal 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 srmklive/paypal (SDK PayPal) est requis.

Guide de configuration

1. Installez et activez d'abord l'add-on E-Shop.
2. Installez le SDK PayPal : composer require srmklive/paypal.
3. Installez et activez l'add-on PayPal.
4. Allez dans PayPal > Paramètres dans le panneau d'administration.
5. Saisissez votre ID client et secret client depuis le Tableau de bord développeur PayPal.
6. Créez un webhook dans le tableau de bord PayPal pointant vers https://votresite.com/paypal/webhook et saisissez l'ID du webhook.
7. Abonnez-vous aux événements : PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.REFUNDED.
8. PayPal apparaîtra comme option de paiement lors du passage en caisse.

Idéal pour

• Sites e-commerce souhaitant la méthode de paiement en ligne la plus reconnue au monde.
• Vendeurs internationaux acceptant les paiements de plus de 200 marchés dans plus de 25 devises.
• Entreprises souhaitant la protection acheteur et les signaux de confiance qui augmentent les taux de conversion.
• Sites ciblant des clients qui préfèrent payer sans saisir directement leurs coordonnées bancaires.
• Vendeurs de produits numériques nécessitant une confirmation de paiement instantanée et sécurisée via webhooks.