MakePay XenForo Fournisseur de paiement

Aperçu

Le module complémentaire officiel MakePay XenForo ajoute la crypto hébergée checkout aux profils de paiement XenForo. XenForo crée la demande d'achat, MakePay crée le lien de paiement hébergé et le gestionnaire de rappel de paiement de XenForo finalise l'achat après un MakePay webhook signé.

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

• XenForo 2.3 ou version ultérieure
• PHP 8.1 ou version ultérieure avec OpenSSL activé
• Forum/communauté HTTPS URL
• Accès administrateur aux profils de paiement
• Une société MakePay où vous pouvez gérer les paramètres de paiement

Installer le module complémentaire

Téléchargez le dernier package ZIP :

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

Installez-le via le programme d'installation d'archive complémentaire de XenForo ou téléchargez le contenu du répertoire upload/ à la racine de votre XenForo. L'ID du module complémentaire est MakePay/Payment et la source est installée à l'emplacement :

src/addons/MakePay/Payment

Connectez MakePay

Accédez à Options > Fournisseurs de services > Profils de paiement > Ajouter un profil de paiement et choisissez MakePay. Enregistrez le profil une fois, rouvrez-le, puis choisissez Connecter MakePay. Le module complémentaire :

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 requises par le fournisseur de paiement XenForo.
4. Vous renvoie à XenForo après approbation.
5. Enregistre la connexion dans les options du profil de paiement.
6. Configure le rappel MakePay URL 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. Revoir:

• ID d'entreprise MakePay
• Devise de règlement
• Expiration du lien de paiement
• Rappel Webhook URL
• Informations d'identification manuelles de secours de la clé API

La solution de secours manuelle nécessite un ID d’entreprise MakePay, un ID de clé API, un secret de clé API et un secret webhook.

Flux de paiement

Ajoutez le profil de paiement MakePay à une mise à niveau utilisateur XenForo, à une ressource payante ou à un autre flux achetable prenant en charge les profils de paiement. Lorsqu'un membre choisit MakePay, le module complémentaire crée un lien de paiement MakePay avec les métadonnées XenForo.

Champ	But
source=xenforo	Identifie l'intégration
orderId=xenforo_purchase_<requestKey>	Mappe l’activité de MakePay à XenForo
requestKey	Clé de demande d'achat XenForo
purchasableTypeId	Type achetable XenForo
moduleVersion	Version complémentaire MakePay installée
xenforoVersion	Version d'exécution XenForo

L'acheteur est redirigé vers l'hébergeur MakePay checkout et revient vers XenForo après paiement ou annulation.

États de paiement

MakePay envoie des rappels signés à :

https://your-forum.example/payment_callback.php?_xfProvider=makepay

Statut MakePay	Résultat du rappel XenForo
paid, completed, confirmed, succeeded	Paiement reçu
failed, expired	Paiement annulé
cancelled, canceled	Paiement annulé
refunded	Paiement annulé
Autres statuts	En attente

XenForo enregistre le journal du fournisseur de paiement avec le paiement MakePay UID, la clé de demande d'achat, le paiement URL lorsqu'il est disponible et la charge utile de rappel.

Notes de sécurité

Le module complémentaire stocke les détails de connexion dans les options du profil de paiement. Gardez l'accès administrateur de XenForo limité aux opérateurs de confiance et déconnectez la communauté dans MakeCrypto si un compte d'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 carte XenForo URL est HTTPS et accessible au public. Si le bouton Connecter MakePay est manquant, enregistrez une fois le profil de paiement et rouvrez-le. Si les achats ne sont pas terminés, comparez le rappel MakePay webhook URL avec le rappel XenForo payment_callback.php?_xfProvider=makepay URL et faites pivoter le secret webhook.