Passerelle MakePay WHMCS

Aperçu

La passerelle officielle MakePay WHMCS ajoute la crypto hébergée checkout aux factures WHMCS. WHMCS affiche un bouton de paiement sur la facture, MakePay crée le lien de paiement hébergé et le rappel signé marque la facture payée une fois le paiement réglé.

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

• WHMCS 8.13 LTS ou WHMCS 9.x
• PHP 8.1 ou version ultérieure avec OpenSSL activé
• Système HTTPS WHMCS URL
• Accès administrateur WHMCS aux passerelles 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/whmcs/latest.zip

Extrayez le ZIP et téléchargez le répertoire modules dans la racine WHMCS. Le package installe ces fichiers :

modules/gateways/makepay.php
modules/gateways/makepay/checkout.php
modules/gateways/makepay/oauth.php
modules/gateways/makepay/lib/*.php
modules/gateways/callback/makepay.php

Dans WHMCS, ouvrez Paramètres système > Passerelles de paiement, activez MakePay, puis enregistrez les paramètres de la passerelle.

Connectez MakePay

Ouvrez les paramètres de la passerelle MakePay et choisissez Connecter MakePay. La passerelle :

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 WHMCS.
4. Vous renvoie à WHMCS après approbation.
5. Enregistre la connexion dans les paramètres de la passerelle WHMCS.
6. Configure le secret de rappel MakePay URL et 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
• Actif de règlement
• Expiration du paiement
• État de connexion MakePay
• Secret de signature Webhook

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 ouvre une facture WHMCS impayée, la passerelle MakePay affiche un bouton de paiement. Le gestionnaire checkout valide la charge utile du formulaire signé, charge la facture via les assistants locaux WHMCS API, crée un lien de paiement MakePay et redirige le client vers l'hébergement MakePay checkout.

Champ	But
source=whmcs	Identifie l'intégration
orderId=whmcs_invoice_<invoiceId>	Mappe l’activité du MakePay vers le WHMCS
invoiceId	Numéro de facture WHMCS
clientId	ID client WHMCS
moduleVersion	Version de passerelle MakePay installée
whmcsVersion	Version d'exécution WHMCS

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

États de facture

MakePay envoie des rappels signés à :

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

Statut MakePay	Comportement du WHMCS
paid, completed, confirmed, succeeded	Appelle addInvoicePayment 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é

Les journaux de transactions WHMCS incluent la charge utile de rappel MakePay afin que les équipes d'assistance puissent retracer le paiement UID, les métadonnées de la facture, le montant et le statut.

Notes de sécurité

La passerelle stocke les détails de connexion dans les paramètres de la passerelle WHMCS. Gardez l'accès administrateur du WHMCS 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 le système WHMCS URL est HTTPS et correspond au domaine de facturation public. Si les clients voient une erreur checkout, confirmez que la passerelle est active, que la facture est impayée et que l'ID de l'entreprise MakePay est stocké. Si les rappels ne marquent pas les factures payées, comparez le rappel MakePay URL avec le rappel WHMCS URL ci-dessus et faites pivoter le secret webhook à partir des paramètres de la passerelle.