Passerelle MakePay Invision Community

Aperçu

L'application officielle MakePay Invision Community ajoute la crypto hébergée checkout à Invision Community 5 Commerce. Commerce crée la facture et la transaction, MakePay crée le lien de paiement hébergé et webhooks signé met à jour la transaction après les événements 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

• Invision Community 5.0 ou version ultérieure
• Application commerciale installée
• PHP 8.1 ou version ultérieure
• Communauté HTTPS URL
• Une société MakePay où vous pouvez gérer les paramètres de paiement

Installer l'application

Téléchargez le dernier package TAR :

https://plugins.makecrypto.io/downloads/invision-community/latest.tar

Installez-le depuis le gestionnaire d'applications Invision AdminCP.

Connectez MakePay

Ouvrez les paramètres de paiement de Commerce et ajoutez MakePay comme mode de paiement. Choisissez Connecter MakePay. La candidature :

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 à la passerelle Invision Community.
4. Vous renvoie à Invision après approbation.
5. Enregistre la connexion du réseau dans les paramètres Invision cryptés.
6. Configure le rappel MakePay webhook URL.

Configurer MakePay

Conservez la méthode de connexion définie sur le mode connecté par défaut après la connexion. Revoir:

• Disponibilité des méthodes de paiement
• ID d'entreprise MakePay
• Rappel Webhook URL
• Journalisation de débogage/demande
• Identifiants de secours manuels pour 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

Lorsqu'un membre choisit MakePay, Invision crée une transaction Commerce et l'application crée un lien de paiement MakePay avec les métadonnées de facture.

Champ	But
source=invision	Identifie l'intégration
externalId=invision_invoice_<id>	Mappe l’activité du MakePay vers Commerce
invoiceId	Numéro de facture Invision Commerce
transactionId	Identifiant de transaction Invision Commerce
moduleVersion	Version de l'application MakePay installée

Le membre est redirigé vers l'hébergement MakePay checkout et revient dans la communauté après paiement ou annulation.

États du commerce

Le point de terminaison webhook vérifie X-MakePay-Signature avant de modifier l’état de la transaction Commerce.

Statut MakePay	État de la transaction d'inspection
paid, completed, confirmed, succeeded	Approuvé
failed, expired	Refusé
cancelled, canceled	Refusé
refunded	Remboursé
Autres statuts	En attente

Chaque webhook écrit un message de facture privée avec le statut MakePay, le paiement UID et le paiement hébergé URL lorsqu'il est disponible.

Notes de sécurité

L'application stocke les détails de connexion dans les paramètres Invision cryptés. Gardez l'accès AdminCP limité aux opérateurs de confiance et déconnectez la passerelle 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 de communauté URL est HTTPS et accessible publiquement. Si les redirections checkout échouent, confirmez que Commerce est installé et que MakePay dispose soit d'une connexion enregistrée, soit d'informations d'identification de secours manuelles avec clé API. Si les factures ne sont pas mises à jour, comparez le rappel MakePay webhook URL avec la communauté webhook URL et faites pivoter le secret webhook.