MakePay ClientExec-Gateway

Überblick

Das offizielle MakePay ClientExec-Gateway fügt gehosteten Krypto-Checkout hinzu ClientExec-Rechnungen. ClientExec erstellt die Rechnung, das Gateway erstellt eine MakePay-Zahlungslink und unterzeichnete Rückrufe kennzeichnen die nachträglich bezahlte Rechnung Zahlung erfolgt.

Wiederkehrende Abrechnungen bleiben in ClientExec. Wenn ClientExec jede Verlängerung erstellt Rechnung, derselbe MakePay-Gateway-Flow ermöglicht es dem Kunden, diese Rechnung zu bezahlen.

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

Bevor Sie beginnen

• ClientExec 6.8 oder neuer, einschließlich ClientExec 7.x
• PHP 7.4 oder neuer mit aktiviertem OpenSSL und cURL
• HTTPS-ClientExec-URL
• ClientExec-Administratorzugriff auf Zahlungsabwickler
• 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/clientexec/latest.zip

Extrahieren Sie die ZIP-Datei und laden Sie den Ordner makepay hoch:

ClientExec/plugins/gateways/makepay

Das Paket installiert diese Dateien:

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

Öffnen Sie in ClientExec Einstellungen > Plugins > Zahlungsabwickler, wählen Sie MakePay aus, und speichern Sie die Einstellungen des Zahlungsabwicklers.

Schließen Sie MakePay an

Öffnen Sie die Einstellungen des Zahlungsprozessors MakePay und kopieren Sie Connect MakePay URL in Ihren Browser ein. Das Tor:

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

Konfigurieren Sie MakePay

Behalten Sie nach Abschluss der Verbindung die Einstellung der Authentifizierungsmethode auf oauth bei. Rezension:

• MakePay Firmen-ID
• Abrechnungsvermögenswert
• Zahlungsablauf
• Webhook-Signaturgeheimnis
• Anmeldename, der Kunden angezeigt wird

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 ClientExec-Rechnung mit MakePay bezahlt, wird das Gateway erstellt einen gehosteten Zahlungslink und leitet den Kunden zum MakePay-Checkout weiter.

Feld	Zweck
source=clientexec	Identifiziert die Integration
orderId=clientexec_invoice_<invoiceId>	Ordnet die MakePay-Aktivität zurück zu ClientExec zu
invoiceId	ClientExec-Rechnungsnummer
clientId	ClientExec-Client-ID, sofern verfügbar
moduleVersion	Installierte MakePay-Gateway-Version
clientexecVersion	ClientExec-Laufzeitversion, sofern verfügbar

Der Käufer retourniert die ursprüngliche ClientExec-Rechnung nach Zahlungseingang bzw Stornierung.

Wiederkehrende Rechnungen

ClientExec bleibt für wiederkehrende Produkte, Verlängerungstermine, Steuern usw. verantwortlich. Rechnungserstellung und Kunden-E-Mails. MakePay erstellt kein separates Abonnementplan in v1.

Für jede wiederkehrende Rechnung, die ClientExec erstellt, verhält sich das MakePay-Gateway wie folgt Dasselbe wie bei einer einmaligen Rechnung: Es wird ein gehosteter Checkout-Link erstellt und auf die Rechnung gewartet unterschriebenen Rückruf, bevor Sie die Rechnung als bezahlt markieren.

Rechnungszustände

MakePay sendet signierte Rückrufe an:

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

MakePay-Status	ClientExec-Verhalten
paid, completed, confirmed, succeeded	Ruft ClientExec zur Zahlungsannahme 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

Sicherheitshinweise

Das Gateway speichert Verbindungsdetails zur ClientExec-Installation. Halten Der ClientExec-Administratorzugriff ist auf vertrauenswürdige Operatoren beschränkt und die Verbindung wird getrennt das Gateway über das MakePay-Dashboard, wenn ein Administratorkonto oder eine Serversicherung vorhanden ist ausgesetzt.

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 ClientExec-URL öffentliches HTTPS ist und der Ordner makepay wird unter plugins/gateways hochgeladen. Wenn Kunden a sehen Beim Bezahlen ist ein Fehler aufgetreten. Bestätigen Sie, dass MakePay verbunden ist und die Rechnung unbezahlt ist. Wenn Bei Rückrufen werden Rechnungen nicht als bezahlt markiert. Vergleichen Sie die Rückruf-URL MakePay mit der Geben Sie oben die Rückruf-URL ein und wechseln Sie das Webhook-Geheimnis aus den Gateway-Einstellungen.