Passerelle MakePay ClientExec

Aperçu

La passerelle officielle MakePay ClientExec ajoute la crypto hébergée checkout aux factures ClientExec. ClientExec crée la facture, la passerelle crée un lien de paiement MakePay et des rappels signés marquent la facture payée une fois le paiement réglé.

La facturation récurrente reste dans ClientExec. Lorsque ClientExec crée chaque facture de renouvellement, le même flux de passerelle MakePay permet au client de payer cette facture.

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

• ClientExec 6.8 ou version ultérieure, y compris ClientExec 7.x
• PHP 7.4 ou version ultérieure avec OpenSSL et cURL activés
• HTTPS ClientExec URL
• Accès administrateur ClientExec aux processeurs de paiement
• Une société MakePay où vous pouvez gérer les paramètres de paiement

Installer la passerelle

Téléchargez le dernier package ZIP :

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

Extrayez le ZIP et téléchargez le dossier makepay vers :

ClientExec/plugins/gateways/makepay

Le package installe ces fichiers :

plugins/gateways/makepay/PluginMakepay.php
plugins/gateways/makepay/PluginMakepayCallback.php
plugins/gateways/makepay/callback.php
plugins/gateways/makepay/oauth.php
plugins/gateways/makepay/lib/*.php

Dans ClientExec, ouvrez Paramètres > Plugins > Processeurs de paiement, sélectionnez MakePay et enregistrez les paramètres du processeur de paiement.

Connectez MakePay

Ouvrez les paramètres du processeur de paiement MakePay et copiez Connect MakePay URL dans votre navigateur. La passerelle :

1. Ouvre la page de connexion du MakePay.
2. Vous demande de vous connecter et de choisir l'entreprise qui doit recevoir les paiements.
3. Affiche les autorisations requises par la passerelle ClientExec.
4. Vous renvoie à ClientExec après approbation.
5. Enregistre la connexion sur l'installation ClientExec.
6. Configure le rappel MakePay URL et le secret webhook.

Configurer MakePay

Une fois la connexion terminée, conservez la méthode d'authentification définie sur oauth. Revoir:

• ID d'entreprise MakePay
• Actif de règlement
• Expiration du paiement
• Secret de signature Webhook
• Nom d'inscription affiché aux clients

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 client paie une facture ClientExec impayée avec MakePay, la passerelle crée un lien de paiement hébergé et redirige le client vers MakePay checkout.

Champ	But
source=clientexec	Identifie l'intégration
orderId=clientexec_invoice_<invoiceId>	Mappe l’activité du MakePay vers le ClientExec
invoiceId	Numéro de facture ClientExec
clientId	ID client ClientExec lorsqu'il est disponible
moduleVersion	Version de passerelle MakePay installée
clientexecVersion	Version d'exécution ClientExec lorsqu'elle est disponible

L'acheteur renvoie la facture originale ClientExec après paiement ou annulation.

Factures récurrentes

ClientExec reste responsable des produits récurrents, des dates de renouvellement, des taxes, de la génération des factures et des e-mails des clients. MakePay ne crée pas de programme d'abonnement distinct dans la v1.

Pour chaque facture récurrente créée par ClientExec, la passerelle MakePay se comporte de la même manière qu'une facture unique : elle crée un lien checkout hébergé et attend le rappel signé avant de marquer cette facture payée.

États de facture

MakePay envoie des rappels signés à :

https://billing.example.com/plugins/gateways/makepay/callback.php

Statut MakePay	Comportement du ClientExec
paid, completed, confirmed, succeeded	Appelle l'acceptation de paiement ClientExec et enregistre l'ID de transaction
failed, expired	Enregistre le rappel et laisse la facture impayée
cancelled, canceled	Enregistre le rappel et laisse la facture impayée
refunded	Enregistre le rappel pour examen manuel
Autres statuts	Connecté et ignoré

Notes de sécurité

La passerelle stocke les détails de connexion sur l'installation ClientExec. Limitez l'accès administrateur du ClientExec aux opérateurs de confiance et déconnectez la passerelle du tableau de bord MakePay 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, vérifiez que le ClientExec URL est un HTTPS public et que le dossier makepay est téléchargé sous plugins/gateways. Si les clients voient une erreur checkout, confirmez que MakePay est connecté et que la facture est impayée. Si les rappels ne marquent pas les factures payées, comparez le rappel MakePay URL avec le rappel URL ci-dessus et faites pivoter le secret webhook à partir des paramètres de la passerelle.