MakePay WHMCS-Gateway

Überblick

Das offizielle WHMCS-Gateway MakePay fügt WHMCS einen gehosteten Krypto-Checkout hinzu Rechnungen. WHMCS rendert eine Zahlungsschaltfläche auf der Rechnung, MakePay erstellt die gehosteter Zahlungslink, und der unterzeichnete Rückruf markiert die nach dem bezahlte Rechnung Zahlung erfolgt.

Verwenden Sie Connect MakePay für die normale Einrichtung. Manuelle API-Schlüssel-Anmeldeinformationen bleiben bestehen als Ersatz verfügbar.

Bevor Sie beginnen

• WHMCS 8.13 LTS oder WHMCS 9.x
• PHP 8.1 oder neuer mit aktiviertem OpenSSL
• HTTPS WHMCS-System-URL
• WHMCS-Administratorzugriff auf Zahlungsgateways
• Ein MakePay-Unternehmen, bei dem Sie Zahlungseinstellungen verwalten können

Installieren Sie das Gateway

Laden Sie das neueste ZIP-Paket herunter:

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

Extrahieren Sie die ZIP-Datei und laden Sie das modules-Verzeichnis in das WHMCS-Stammverzeichnis hoch. Der Paket installiert diese Dateien:

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

Öffnen Sie in WHMCS Systemeinstellungen > Zahlungsgateways, aktivieren Sie MakePay und speichern Sie dann die Gateway-Einstellungen.

Schließen Sie MakePay an

Öffnen Sie die Gateway-Einstellungen MakePay und wählen Sie MakePay verbinden. Das Tor:

1. Öffnet MakeCrypto in einem Browser-Tab.
2. Fordert Sie auf, sich anzumelden und das Unternehmen auszuwählen, das Zahlungen erhalten soll.
3. Zeigt die vom WHMCS-Gateway benötigten Berechtigungen an.
4. Bringt Sie nach der Genehmigung zu WHMCS zurück.
5. Speichert die Verbindung in den WHMCS-Gateway-Einstellungen.
6. Konfiguriert die MakePay-Rückruf-URL und das Webhook-Geheimnis.

Konfigurieren Sie MakePay

Behalten Sie nach Abschluss der Verbindung die Einstellung der Verbindungsmethode auf der Standardverbindung bei Modus. Rezension:

• MakePay Firmen-ID
• Abrechnungsvermögenswert
• Zahlungsablauf
• MakePay Verbindungsstatus
• Webhook-Signaturgeheimnis

Für den manuellen Fallback sind eine MakePay-Unternehmens-ID, eine API-Schlüssel-ID, ein API-Schlüsselgeheimnis usw. erforderlich Webhook-Geheimnis.

Checkout-Ablauf

Wenn ein Kunde eine unbezahlte WHMCS-Rechnung öffnet, rendert das MakePay-Gateway eine Zahlungsschaltfläche. Der Checkout-Handler validiert die Nutzlast des signierten Formulars und lädt die Rechnung über die lokalen API-Helfer von WHMCS erstellt einen MakePay-Zahlungslink, und leitet den Kunden zum gehosteten MakePay-Checkout weiter.

Feld	Zweck
source=whmcs	Identifiziert die Integration
orderId=whmcs_invoice_<invoiceId>	Ordnet die MakePay-Aktivität zurück zu WHMCS zu
invoiceId	WHMCS-Rechnungs-ID
clientId	WHMCS-Client-ID
moduleVersion	Installierte MakePay-Gateway-Version
whmcsVersion	WHMCS-Laufzeitversion

Der Käufer kehrt nach Zahlung oder Stornierung zur ursprünglichen WHMCS-Rechnung zurück.

Rechnungszustände

MakePay sendet signierte Rückrufe an:

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

MakePay-Status	WHMCS-Verhalten
paid, completed, confirmed, succeeded	Ruft addInvoicePayment auf und zeichnet die Transaktions-ID auf
failed, expired	Protokolliert den Rückruf und lässt die Rechnung unbezahlt
cancelled, canceled	Protokolliert den Rückruf und lässt die Rechnung unbezahlt
refunded	Protokolliert den Rückruf zur manuellen Überprüfung
Andere Status	Protokolliert und ignoriert

WHMCS-Transaktionsprotokolle enthalten die Rückrufnutzlast MakePay, damit Supportteams dies tun können Verfolgen Sie die Zahlungs-UID, Rechnungsmetadaten, den Betrag und den Status.

Sicherheitshinweise

Das Gateway speichert Verbindungsdetails in den WHMCS-Gateway-Einstellungen. Behalten Sie WHMCS Der Administratorzugriff ist auf vertrauenswürdige Betreiber beschränkt, und die Verbindung zum Gateway wird unterbrochen MakeCrypto, wenn ein Administratorkonto oder eine Serversicherung verfügbar gemacht wird.

Die Verbindung fragt nach diesen Berechtigungen:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

Fehlerbehebung

Wenn Connect MakePay nicht gestartet werden kann, bestätigen Sie, dass die WHMCS-System-URL HTTPS ist und entspricht der öffentlichen Abrechnungsdomäne. Wenn Kunden einen Checkout-Fehler sehen, bestätigen Sie diesen Gateway ist aktiv, die Rechnung ist unbezahlt und die Firmen-ID MakePay ist gespeichert. Wenn Rückrufe Rechnungen nicht als bezahlt markieren, vergleichen Sie die Rückruf-URL MakePay mit Geben Sie die obige WHMCS-Rückruf-URL ein und rotieren Sie das Webhook-Geheimnis vom Gateway Einstellungen.