Plugins e-commerce

Module PrestaShop

Installez et configurez le module officiel PrestaShop avec OAuth natif, les jetons DPoP et les webhooks MakePay.

Aperçu

MakePay pour PrestaShop permet aux commerçants d'accepter les paiements cryptés via MakePay checkout hébergé. Les clients choisissent le mode de paiement MakePay pendant PrestaShop checkout, sont redirigés vers MakePay pour payer et retournent au magasin après le paiement.

Le module crée un lien de paiement MakePay pour chaque commande PrestaShop et écoute les MakePay webhooks signés afin que les changements d'état de la commande se produisent automatiquement.

Avant de commencer

Vous aurez besoin de :

PrestaShop 8.0 ou version ultérieure, y compris PrestaShop 9.x
PHP 7.4 ou version ultérieure avec OpenSSL activé
Un Back Office HTTPS et checkout URL
Un compte collaborateur PrestaShop permettant de configurer des modules
Une société MakeCrypto avec un règlement MakePay configuré

Le sodium PHP est recommandé. Lorsqu'il est disponible, le module l'utilise avec les secrets de cookie PrestaShop pour crypter les détails de connexion, les secrets webhook et les informations d'identification manuelles de secours de la clé API.

Configurer MakeCrypto

Terminez la configuration du merchant avant de connecter le PrestaShop.

Connectez-vous à https://www.makecrypto.io et sélectionnez l'entreprise qui devrait recevoir les paiements PrestaShop.
Ouvrez Wallet > Soldes, puis configurez la devise, la chaîne et les paramètres de règlement. portefeuille de destination.
Ouvrez ** Marchand > Paramètres de paiement **, examinez les frais de paiement et redirigez. comportement.
Facultatif : ouvrez Paramètres > Marchand pour ajouter la marque merchant et l'assistance. e-mail, couleurs checkout, thème de paiement hébergé et domaines personnalisés.

Vous n'avez pas besoin de créer manuellement une application de développement. Le module officiel PrestaShop crée une connexion spécifique au magasin lorsque vous cliquez sur Connecter MakePay.

Installer le module

Téléchargez le dernier module officiel ZIP :

https://plugins.makecrypto.io/downloads/prestashop/latest.zip

Installez-le ensuite dans PrestaShop :

Ouvrez Back Office > Modules > Gestionnaire de modules.
Cliquez sur Télécharger un module et choisissez le makepay.zip téléchargé.
Après l'installation, cliquez sur Configurer.
Gardez Authentification défini sur le mode connecté par défaut.

La racine du ZIP est makepay/ et le fichier du module principal est makepay.php, correspondant aux attentes en matière d'emballage du module PrestaShop.

Paramètres du module MakePay dans PrestaShop après la connexion OAuth, affichant l'état de l'entreprise connectée, webhook URL, le mode checkout et la configuration de la passerelle.

Connectez votre boutique

Utilisez Connect MakePay pour une configuration normale. Il relie ce magasin PrestaShop à la société MakeCrypto que vous choisissez et peut être déconnecté ultérieurement sans changer le code du magasin.

Dans la configuration du module MakePay, laissez MakePay API base URL réglé sur https://www.makecrypto.io.
Cliquez sur Connecter MakePay.
Connectez-vous à MakeCrypto si vous y êtes invité, choisissez l'entreprise que vous avez préparée et approuver l’accès demandé.
Après être revenu à PrestaShop, confirmez que le module affiche le magasin comme connecté.
Enregistrez les paramètres de la passerelle et gardez le module activé.

Lors de la connexion, le module enregistre automatiquement le public webhook URL :

https://your-store.example/module/makepay/webhook

Gardez ce point de terminaison accessible depuis l’Internet public. Les modules de sécurité, les pare-feu et les règles de mise en cache doivent autoriser les requêtes POST signées vers ce URL.

Comment fonctionne la connexion

Le bouton Connecter MakePay ouvre le MakeCrypto dans un onglet de navigateur. Vous vous connectez, choisissez l'entreprise qui doit recevoir les paiements, vérifiez l'accès demandé et revenez à PrestaShop après approbation. Le module enregistre ensuite la connexion, enregistre le webhook URL et conserve les paramètres séparés pour chaque contexte de boutique dans les installations multimagasins.

Aucun secret d'application partagé ni configuration d'application de développeur n'est requis pour le PrestaShop.

Paramètres de la passerelle

Vérifiez ces paramètres dans Modules > Module Manager > MakePay > Configure.

Paramètre	Ce que ça fait
Activé	Active ou désactive le mode de paiement MakePay sur checkout.
Authentification	Utilisez le mode connecté par défaut pour les installations normales. Le remplacement manuel de la clé API est destiné à la récupération pilotée par l'assistance.
Nom du mode de paiement	Le nom que les clients voient sur checkout, par exemple `Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others`.
Expérience de paiement	Utilisez la Redirection hébergée pour le flux le plus fiable, ou la Page checkout intégrée pour afficher MakePay dans une page iframe sécurisée avec un lien hébergé de secours.
Devise de règlement	Actif MakePay préféré tel que `USDT`. MakePay résout la chaîne à partir des paramètres de l'entreprise lorsque cela est possible.
Expiration du paiement	Durée de vie checkout hébergée, par exemple `30m`, `2h` ou `12h`.
Base MakePay API URL	Utilisez `https://www.makecrypto.io` pour la production.
Identifiant de l'entreprise / ID de clé API / Clé secrète API	Requis uniquement pour le repli manuel de la clé API.
Webhook secret	Réglé automatiquement lors de la connexion. Entrez manuellement uniquement pour le mode de secours.

États de la commande

Sur checkout, le module crée une commande PrestaShop dans l'état personnalisé En attente de paiement MakePay et ouvre l'expérience MakePay checkout sélectionnée.

Mappage d’état Webhook :

Statut MakePay	État PrestaShop
`paid`, `completed`, `confirmed`, `succeeded`	Paiement accepté
`refunded`, `refund`	Remboursé
`failed`, `expired`, `chargeback`	Erreur de paiement
`cancelled`, `canceled`	Annulé
autres statuts en cours	En attente de paiement MakePay

Le module écrit des messages de commande privés avec le statut webhook, le paiement UID, le montant, l'actif et le paiement URL lorsqu'il est présent dans la charge utile MakePay webhook.

PrestaShop checkout affichant MakePay comme mode de paiement crypté sélectionné avant de passer la commande.

MakePay public hébergé checkout ouvert à partir d'une commande PrestaShop, indiquant le montant du paiement et les méthodes de paiement cryptées disponibles.

Détails de la commande PrestaShop après qu'un MakePay signé webhook ait marqué la commande comme payée et ajouté des notes de paiement privées.

Détails du lien de paiement MakeCrypto pour une commande PrestaShop, y compris l'ID de commande merchant, l'état du paiement, le montant et la traçabilité administrative.

Sécurité et autorisations

La connexion PrestaShop demande :

company:read
makepay:payment-links:read
makepay:payment-links:write
makepay:customers:read
makepay:customers:write
makepay:settings:read
makepay:settings:write

Il ne peut pas envoyer de fonds de portefeuille ni créer d'anciennes clés API.

Les mises à jour Webhook sont signées par MakePay et vérifiées avant tout changement d'état de commande PrestaShop. Les administrateurs de la boutique peuvent révoquer la connexion dans MakeCrypto sous Intégrations > Applications connectées, ou la déconnecter de la page de configuration du module PrestaShop.

Repli manuel sur la clé API

Utilisez le mode manuel API-key uniquement si Connect MakePay n'est pas disponible ou si le support MakeCrypto vous demande de l'utiliser.

Dans MakeCrypto, ouvrez Intégrations > Intégrations API.
Créez ou choisissez une clé MakePay API pour la même entreprise qui reçoit le magasin paiements.
Copiez l'ID de l'entreprise, l'ID de clé API, la clé secrète API et la clé secrète webhook.
Dans PrestaShop, ouvrez Modules > Module Manager > MakePay > Configure.
Définissez Authentification sur Repli manuel de la clé API.
Collez les informations d'identification et enregistrez.

Conservez les secrets clés de API hors des fichiers de thème, des scripts côté client et des tickets d'assistance publics. Connect MakePay est toujours préférable pour le fonctionnement normal du magasin.

Dépannage

Si Connect MakePay échoue, confirmez que votre back-office URL utilise HTTPS, que votre magasin peut envoyer des requêtes HTTPS sortantes à https://www.makecrypto.io et que le compte de l'employé peut configurer des modules.

Si le mode de paiement n'apparaît pas sur checkout, confirmez que le module est actif, que Enabled est activé et que le magasin est connecté à MakePay ou dispose d'informations d'identification manuelles valides avec clé API.

Si checkout affiche une erreur de règlement ou d'intégration, revenez à MakeCrypto et complétez Portefeuille > Soldes > Configurer le règlement pour l'entreprise connectée au magasin.

Si les commandes ne sont pas mises à jour après le paiement, vérifiez Intégrations > Demandes Webhook dans MakeCrypto pour les tentatives de livraison. Le point de terminaison PrestaShop webhook doit renvoyer une réponse 2xx. Vérifiez également que les pare-feu d'hébergement ne bloquent pas les requêtes POST adressées à /module/makepay/webhook.

Si vous modifiez le domaine du magasin, le domaine du Back Office ou déplacez la boutique vers un nouvel environnement, déconnectez et reconnectez MakePay afin que le rappel de connexion et les URL webhook correspondent à la boutique actuelle.