Plugin MakePay VirtueMart

Aperçu

Le plugin MakePay VirtueMart ajoute une méthode de paiement cryptée hébergée aux magasins Joomla qui utilisent VirtueMart. Les clients choisissent MakePay chez checkout, paient sur la page MakePay checkout et retournent au magasin pendant que VirtueMart conserve le dossier de commande.

Les notifications de paiement signées mettent à jour la commande VirtueMart après le paiement, afin que l'équipe du magasin puisse continuer à gérer les commandes dans VirtueMart.

Avant de commencer

• Joomla avec VirtueMart installé
• PHP 7.4 ou version ultérieure avec OpenSSL et cURL activés
• Une vitrine HTTPS publique URL
• Accès à l'installation de l'extension Joomla et aux méthodes de paiement VirtueMart
• Une société MakePay avec règlement et branding configurés

Installer le plugin

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

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

Dans Joomla, ouvrez Système > Extensions, téléchargez le ZIP, puis activez VM Payment - MakePay Crypto Payment Gateway à partir du gestionnaire de plugins.

Dans VirtueMart, ouvrez Modes de paiement, créez un mode de paiement, choisissez le plug-in de paiement MakePay et enregistrez-le une fois afin que VirtueMart attribue un identifiant de mode de paiement.

Connectez MakePay

Une fois le mode de paiement enregistré, ouvrez la connexion URL depuis la vitrine. Remplacez PAYMENT_METHOD_ID par l'ID du mode de paiement VirtueMart :

https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID

MakePay vous demande de vous connecter, de choisir l'entreprise qui doit recevoir les paiements et d'approuver la connexion. Après approbation, le plugin stocke la connexion sur ce mode de paiement VirtueMart et configure le rappel MakePay URL.

Paramètres de la passerelle

Vérifiez ces champs avant d'activer publiquement le mode de paiement :

Paramètre	But
Méthode de connexion	Utilisez Connect MakePay pour une configuration normale ou les touches manuelles API comme solution de secours.
ID d’entreprise MakePay	Rempli après la connexion, ou saisi manuellement pour secours
Devise de règlement	Actif de règlement préféré, tel que USDT
Expiration du paiement	Combien de temps le lien hébergé checkout reste payable
secret Webhook	Utilisé pour vérifier les notifications de paiement MakePay
Statuts des commandes	Statuts VirtueMart pour les paiements en attente, payés, en échec, expirés, annulés et remboursés

Flux de paiement

Lorsqu'un acheteur sélectionne MakePay, le plugin crée un lien de paiement MakePay avec :

Champ	But
source=virtuemart	Identifie l'intégration
orderId=virtuemart_order_<id>	Mappe l’activité de MakePay à VirtueMart
orderNumber	Numéro de commande du VirtueMart indiqué sur le merchant
pluginVersion	Version du plugin MakePay installée
virtuemartVersion	Version d'exécution VirtueMart lorsqu'elle est disponible

L'acheteur est redirigé vers checkout hébergé. MakePay envoie ensuite une notification signée au point de terminaison de notification du plug-in VirtueMart.

États de commande

Statut MakePay	Comportement du VirtueMart
paid, completed, confirmed, succeeded	Déplace la commande vers le statut payé configuré
expired	Déplace la commande vers le statut expiré configuré
failed	Déplace la commande vers le statut d'échec configuré
cancelled, canceled	Déplace la commande vers le statut annulé configuré
refunded	Déplace la commande vers le statut remboursé configuré
Autres statuts	Ignoré jusqu'à ce qu'un état de paiement final arrive

Chaque mise à jour écrit un commentaire de commande privé avec la transaction MakePay, le montant, l'actif et le paiement URL lorsque ces champs sont présents.

Manuel de secours API-Key

Si le flux de connexion ne peut pas être utilisé, définissez Méthode de connexion sur Repli manuel de la clé API et saisissez :

• ID d'entreprise MakePay
• ID de clé API
• Clé secrète API
• secret Webhook

Utilisez-le uniquement en cas de besoin et limitez l'accès des administrateurs Joomla aux opérateurs de confiance.

Dépannage

If checkout cannot start, confirm the payment method has a company connection or manual API-key settings. Si la connexion URL échoue, confirmez que la vitrine est HTTPS publique et que la valeur pm pointe vers le mode de paiement MakePay enregistré.

Si les commandes ne sont pas mises à jour, comparez le rappel MakePay URL avec la notification du plugin VirtueMart URL et faites pivoter le secret webhook à partir des paramètres du mode de paiement.