Activer et configurer PayPal Checkout dans Shopware 6 : compte Business, identifiants API, moyens de paiement (dont le paiement en 4X), mode test et erreurs fréquentes, pour les boutiques en ligne en France.
Lorsque vous possédez une boutique en ligne, l’une des premières choses à offrir à vos clients est un moyen de paiement sûr et pratique. Une option de paiement fiable renforce la confiance des visiteurs et augmente la probabilité qu’ils finalisent leur achat.
PayPal compte parmi les moyens de paiement les plus connus et les plus fiables au monde. Rapide, sûr et compatible avec de nombreuses devises et de nombreux pays, il est utilisé chaque jour par des millions de personnes pour leurs achats en ligne. En France, de nombreuses boutiques en ligne le proposent aux côtés de la Carte Bancaire (CB). Il est donc logique d’intégrer PayPal à votre boutique Shopware 6.
Ce guide vous permet d’ajouter PayPal pas à pas à votre boutique Shopware 6. Vous apprendrez à :
Après avoir suivi ce tutoriel, votre boutique Shopware 6 sera prête à accepter PayPal, les cartes de crédit et de débit, le prélèvement SEPA et, selon les pays, des options de paiement différé ou fractionné (en France, le paiement en 4X PayPal).
PayPal est un service de paiement en ligne. Il permet aux utilisateurs d’envoyer et de recevoir de l’argent en ligne pour des biens et des services. PayPal fonctionne comme un portefeuille virtuel : les clients se connectent simplement à leur compte PayPal, l’alimentent, y associent des comptes bancaires ou des cartes, puis effectuent leurs paiements.
Les avantages de PayPal
Le plugin Shopware PayPal Checkout
Le plugin officiel PayPal Checkout est disponible pour Shopware 6. C’est la solution la plus récente et la plus complète pour intégrer PayPal à votre boutique en ligne. Il prend en charge les fonctions suivantes :
Les anciens plugins séparés sont remplacés par un plugin unique qui gère toutes les fonctions de votre boutique en un seul endroit.
Avant de configurer PayPal dans votre boutique Shopware 6, vérifiez que vous disposez des éléments suivants :
Le plugin PayPal est compatible avec Shopware 6.4 et les versions ultérieures. Mettez votre boutique à jour si elle utilise une version obsolète.
Votre boutique doit disposer d’un certificat SSL fonctionnel et utiliser HTTPS.
Vérifiez que PHP 8.1 ou une version plus récente est installé sur votre serveur.
Un compte PayPal personnel ne permet pas de recevoir des paiements dans votre boutique.
Ces identifiants sont nécessaires pour connecter votre compte PayPal à votre boutique Shopware.
Allez sur https://developer.paypal.com. Connectez-vous avec votre compte PayPal professionnel ou personnel.
Si vous avez déjà un compte PayPal, cliquez simplement sur « Se connecter ». Sinon, choisissez « S’inscrire ». Deux options s’offrent à vous : Personnel ou Professionnel. Pour ce guide, le compte « Personnel » a été choisi, car il suffit pour les tests et se configure plus simplement ; pour encaisser de vrais paiements dans votre boutique, un compte Professionnel reste indispensable (voir la section 3). Cliquez sur « Get Started » pour continuer.
Inscrivez-vous ensuite en renseignant toutes vos informations personnelles. Par sécurité, PayPal vous envoie un code de vérification : indiquez donc un numéro de téléphone valide. Saisissez le code dès réception et cliquez sur « Continuer ».
Une fois l’inscription terminée, connectez-vous avec votre e-mail et votre mot de passe.
Vous êtes alors redirigé vers votre tableau de bord PayPal, semblable à l’image ci-dessous.
Dans le tableau de bord PayPal, cliquez sur « Apps & Credentials » pour continuer.
Vérifiez que le mode sandbox est activé, afin de tout tester en toute sécurité avant la mise en production.
Cliquez sur le bouton « Create App ».
Donnez un nom à votre application, par exemple « Shopware Integration ».
Sélectionnez votre compte professionnel et cliquez sur « Create App ». PayPal génère automatiquement un Client ID et une clé secrète.
Une fois l’application créée :
Dans le même tableau de bord, vous pouvez créer des comptes fictifs d’acheteur et de vendeur.
Ils vous permettent de tester des transactions sans utiliser d’argent réel. Le meilleur moyen de tout tester en conditions proches du réel reste toutefois de passer directement par Shopware, comme expliqué dans les étapes suivantes.
Ouvrez le backend de votre boutique Shopware 6 et connectez-vous avec votre compte administrateur. Par défaut, le nom d’utilisateur est souvent admin et le mot de passe shopware, sauf s’ils ont été modifiés lors de l’installation (ce que nous recommandons vivement).
Dans le menu de gauche, allez dans Extensions > Store pour ouvrir la place de marché Shopware. Vous pouvez aussi accéder aux paramètres PayPal via Paramètres > Boutique > Modes de paiement.
Saisissez « PayPal Checkout » dans la barre de recherche.
Cliquez sur le plugin dans la liste.
Cliquez sur « Installer », puis sur « Activer ».
Après l’installation, vous trouverez le plugin PayPal sous Extensions > Mes extensions ou sous Paramètres > Extensions, selon la configuration de Shopware.
Dans la liste des extensions, sélectionnez PayPal et cliquez sur … > Configurer ou Paramètres.
Vous pouvez aussi effectuer cette étape directement dans la section « Paramètres ».
Commencez en mode sandbox, prévu pour les tests.
Passez ensuite en mode live pour les commandes réelles.
Collez votre Client ID et votre Secret issus du PayPal Developer Dashboard.
Activez les options de paiement souhaitées, par exemple :
Vous pouvez sélectionner plusieurs options à la fois : toutes sont gérées par le plugin.
Le plugin crée automatiquement une URL de webhook. Elle permet à PayPal d’informer votre boutique des événements de transaction (par exemple paiement finalisé ou remboursé). Vous n’avez rien à configurer manuellement.
Vérifiez que le plugin est toujours en mode sandbox et que vos identifiants API sandbox sont correctement saisis.
Rendez-vous sur votre Storefront, ajoutez un produit au panier et choisissez PayPal comme moyen de paiement.
Connectez-vous avec votre compte acheteur sandbox et effectuez le paiement.
Après l’envoi de la commande :
Ouvrez les paramètres du plugin PayPal et passez du mode sandbox au mode live.
Remplacez votre Client ID et votre Secret sandbox par les identifiants live du Developer Dashboard.
Utilisez votre compte PayPal personnel pour acheter un article dans votre boutique. Ce dernier test garantit que tout fonctionne en conditions réelles.
Une fois ce test réussi, votre boutique est prête à accepter les paiements PayPal de vrais clients.
Même si chaque boutique est un peu différente, configurer PayPal dans Shopware 6 est généralement simple. Voici quelques conseils supplémentaires pour éviter les surprises et garantir une intégration sans accroc :
Le plugin PayPal Checkout propose en outre des fonctions optionnelles, à activer selon les pays et les préférences de vos clients :
Apple Pay et Google Pay : ces options nécessitent des étapes de configuration supplémentaires.
Boutons de checkout express : les boutons « Express Checkout » de PayPal peuvent être ajoutés directement sur la fiche produit ou dans le panier.
PayPal Performance Dashboard : après la mise en ligne, nous vous conseillons d’utiliser le tableau de bord PayPal Business pour suivre la performance de la boutique.
Intégrer PayPal à votre boutique Shopware 6 est un bon moyen d’augmenter le taux de conversion, d’optimiser le checkout et de renforcer la confiance des clients. Avec la prise en charge de nombreux moyens de paiement, devises et pays en un seul endroit, le plugin officiel PayPal Checkout simplifie le processus comme jamais. Pour une boutique en France, pensez à proposer PayPal en complément de la Carte Bancaire et à indiquer clairement les moyens de paiement acceptés dans vos CGV.
Voici un bref récapitulatif des étapes :
N’hésitez pas à contacter le support Shopware ou directement les développeurs du plugin via l’Extension Store si vous rencontrez des problèmes que vous ne pouvez pas résoudre seul. PayPal met également à disposition, sur demande, des outils de support et une documentation pour les développeurs.
Vous êtes maintenant prêt à enrichir votre boutique avec PayPal !