Module MakePay Magento

Aperçu

Le module officiel MakePay Magento ajoute une méthode de cryptographie hébergée checkout aux magasins Magento Open Source et Adobe Commerce 2.4.x. Magento crée la commande, MakePay crée le lien de paiement hébergé et webhooks signé met à jour la commande après le changement de statut de paiement.

Utilisez Connect MakePay pour une configuration normale. Les informations d’identification manuelles de la clé API restent disponibles en guise de solution de secours.

Avant de commencer

• Magento Open Source ou Adobe Commerce 2.4.x
• PHP 8.1 ou version ultérieure
• Accès administrateur aux magasins > Configuration > Ventes > Modes de paiement
• Une société MakePay où vous pouvez gérer les paramètres de paiement

Installer le module

Téléchargez la dernière version du ZIP :

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

Extrayez le package pour que le module se trouve à l'emplacement :

app/code/MakePay/Payment

Activez-le depuis votre racine Magento :

bin/magento module:enable MakePay_Payment
bin/magento setup:upgrade
bin/magento cache:clean

Connectez MakePay

Ouvrez Magasins > Configuration > Ventes > Modes de paiement > MakePay et sélectionnez Connecter MakePay. Le module :

1. Ouvre MakeCrypto dans un onglet de navigateur.
2. Vous demande de vous connecter et de choisir l'entreprise qui doit recevoir les paiements.
3. Affiche les autorisations nécessaires au module Magento.
4. Vous renvoie à Magento après approbation.
5. Enregistre la connexion au magasin dans la configuration cryptée Magento.
6. Configure le rappel MakePay webhook et le secret webhook.

Configurer MakePay

Une fois la connexion terminée, conservez la méthode de connexion définie sur le mode connecté par défaut. Activez le mode de paiement et vérifiez :

• Nom du mode de paiement
• Expérience de paiement
• Devise de règlement
• Expiration du lien de paiement
• Statuts des commandes en attente, payées, échouées, annulées et remboursées

Le remplacement manuel de la clé API nécessite un ID d'entreprise MakePay, un ID de clé API, un secret de clé API et un secret webhook.

Flux de paiement

Lorsqu'un client choisit MakePay, Magento passe la commande en attente de paiement, puis ouvre l'expérience MakePay checkout sélectionnée. La redirection hébergée est la valeur par défaut recommandée ; Le checkout intégré affiche une page sécurisée MakePay iframe avec un lien de secours hébergé.

La charge utile du lien de paiement comprend :

Champ	But
source=magento	Identifie l'intégration
orderId=magento_order_<id>	Mappe l’activité du MakePay vers le Magento
incrementId	Numéro de commande Magento lisible par l'homme
magentoOrderAdminUrl	Permet à MakeCrypto de relier les administrateurs à la commande Magento
moduleVersion	Version du module MakePay installée
magentoVersion	Version d'exécution Magento ou Adobe Commerce

États de commande

Le point de terminaison webhook est /makepay/webhook/index. Il vérifie l'en-tête X-MakePay-Signature avant de mettre à jour une commande.

Statut MakePay	État Magento
paid, completed, confirmed, succeeded	Traitement
failed, expired	Annulé
cancelled, canceled	Annulé
refunded	Fermé
Autres statuts	En attente de paiement

Chaque webhook écrit un commentaire privé sur l'historique des commandes avec l'état du paiement, le MakePay public checkout URL, le tableau de bord MakeCrypto URL et les identifiants MakePay disponibles.

Notes de sécurité

Le module stocke les détails de connexion dans la configuration cryptée Magento. Gardez l'accès administrateur de Magento limité aux opérateurs de confiance et déconnectez le magasin dans MakeCrypto si un compte administrateur ou une sauvegarde de serveur est exposé.

La connexion demande ces autorisations :

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

Dépannage

Si Connect MakePay ne peut pas démarrer, confirmez que la base Magento URL est HTTPS et accessible publiquement. Si les redirections checkout échouent, confirmez que le module est activé et que MakePay dispose soit d'une connexion enregistrée, soit d'informations d'identification de secours manuelles avec clé API. Si les commandes ne sont pas mises à jour, comparez le rappel webhook URL dans les paramètres MakePay avec le rappel Magento /makepay/webhook/index URL et faites pivoter le secret webhook.