api paypal prestashop : comment paramétrer et relier ?

PrestaShop : Créer un compte PayPal Business

Avant d’utiliser l’API PayPal dans PrestaShop, vous devez créer un compte PayPal Business. Ce type de compte permet d’accéder aux identifiants API, nécessaires pour relier votre boutique PrestaShop à PayPal.

Rendez-vous sur paypal.com, sélectionnez Créer un compte professionnel, puis remplissez les informations de votre entreprise. Ce compte donne accès à toutes les fonctionnalités avancées de l’API PayPal.

PrestaShop : Activer les identifiants API dans PayPal

Une fois votre compte Business actif, allez dans votre espace développeur PayPal via developer.paypal.com, puis accédez à la section My Apps & Credentials. Créez une nouvelle application REST API.

Vous obtiendrez un Client ID et un Secret, qui sont les deux clés essentielles pour connecter votre boutique PrestaShop à l’API PayPal. Ces identifiants sont uniques à chaque environnement : sandbox ou live.

PrestaShop : Installer un module compatible API PayPal

Pour utiliser l’API PayPal dans PrestaShop, installez le module officiel PayPal ou PrestaShop Checkout. Ces modules sont conçus pour exploiter les API REST modernes de PayPal sans configuration complexe.

Depuis le back-office PrestaShop, allez dans Modules > Catalogue de modules, recherchez PayPal, puis installez et activez le module. Celui-ci propose une interface pour connecter automatiquement votre compte via l’API.

PrestaShop : Relier le module PayPal via authentification directe

La méthode la plus simple pour connecter l’API PayPal à PrestaShop est d’utiliser l’authentification directe intégrée dans le module. Cliquez sur Se connecter à PayPal, puis validez l’autorisation.

Une fois la liaison faite, les identifiants API sont automatiquement enregistrés dans votre module PrestaShop. Vous n’avez plus besoin d’ajouter manuellement les clés de sécurité, ce qui réduit les risques d’erreurs.

PrestaShop : Ajouter manuellement les clés API (option avancée)

Si vous préférez une configuration manuelle, vous pouvez coller le Client ID et le Secret dans les champs prévus du module PayPal. Cette option se trouve dans Paramètres Avancés > Configuration API.

Assurez-vous de bien choisir entre l’environnement sandbox (test) et live (production). Une erreur de clé ou d’environnement peut empêcher PrestaShop de communiquer correctement avec PayPal.

PrestaShop : Tester l’API en mode sandbox

Avant d’activer l’API en production, testez-la dans l’environnement sandbox. Cela vous permet de simuler des transactions PayPal fictives depuis votre boutique PrestaShop, sans effectuer de paiements réels.

Le mode sandbox est utile pour valider la communication entre PrestaShop et PayPal, vérifier l’enregistrement des commandes, et tester les statuts. Cela évite les mauvaises surprises lors du passage en réel.

PrestaShop : Activer le mode production de l’API

Une fois les tests terminés, vous pouvez passer en mode production. Connectez-vous avec vos identifiants API live, soit en mode automatique, soit en collant manuellement les clés API réelles.

Dans PrestaShop, cette action permet de débloquer les paiements réels et de commencer à recevoir de l’argent sur votre compte PayPal. Pensez à sauvegarder vos réglages pour ne rien perdre en cas de mise à jour.

PrestaShop : Vérifier les autorisations API côté PayPal

Assurez-vous que votre compte PayPal a bien les autorisations API nécessaires : gestion des paiements, accès aux remboursements, et visualisation des transactions. Ces droits d’accès sont nécessaires pour une intégration complète.

Dans votre tableau de bord PayPal, vérifiez que votre application a les permissions suffisantes. Si un service est manquant, certaines fonctions de PrestaShop, comme les remboursements automatisés, peuvent échouer.

PrestaShop : Activer les webhooks pour retour de paiement

L’API PayPal fonctionne avec un système de webhooks qui permet à PayPal de notifier automatiquement PrestaShop après chaque paiement. Ces webhooks assurent une mise à jour instantanée des commandes.

Le module PayPal pour PrestaShop peut créer ces webhooks automatiquement, mais vous pouvez aussi les gérer depuis votre compte développeur PayPal. Ils sont essentiels pour recevoir des notifications en temps réel.

PrestaShop : Surveiller les erreurs API et les logs

Après configuration, surveillez régulièrement les logs API dans le module PayPal de PrestaShop. Ils vous indiquent si des erreurs de communication surviennent, comme des identifiants incorrects ou des requêtes rejetées.

Cela permet de corriger rapidement les problèmes et de garantir une stabilité totale de l’API PayPal. Le suivi des logs est crucial pour une boutique PrestaShop avec un volume élevé de transactions.