MakePay Invision Community Gateway

Überblick

Die offizielle MakePay Invision Community-Anwendung fügt einen gehosteten Krypto-Checkout hinzu zu Invision Community 5 Commerce. Commerce erstellt die Rechnung und Transaktion, MakePay erstellt den gehosteten Zahlungslink und signierte Webhooks aktualisieren ihn Transaktion nach Zahlungsereignissen.

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

Bevor Sie beginnen

• Invision Community 5.0 oder neuer
• Commerce-Anwendung installiert
• PHP 8.1 oder neuer
• HTTPS-Community-URL
• Ein MakePay-Unternehmen, bei dem Sie Zahlungseinstellungen verwalten können

Installieren Sie die Anwendung

Laden Sie das neueste TAR-Paket herunter:

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

Installieren Sie es über den Invision AdminCP-Anwendungsmanager.

Schließen Sie MakePay an

Öffnen Sie die Commerce-Zahlungseinstellungen und fügen Sie MakePay als Zahlungsmethode hinzu. Wählen Schließen Sie MakePay an. Die Bewerbung:

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 Invision Community Gateway benötigten Berechtigungen an.
4. Bringt Sie nach der Genehmigung zurück zu Invision.
5. Speichert die Community-Verbindung in verschlüsselten Invision-Einstellungen.
6. Konfiguriert die Webhook-Rückruf-URL MakePay.

Konfigurieren Sie MakePay

Behalten Sie die Einstellung der Verbindungsmethode nach der Verbindung auf dem standardmäßigen Verbindungsmodus bei. Rezension:

• Verfügbarkeit der Zahlungsmethode
• MakePay Firmen-ID
• Webhook-Rückruf-URL
• Debug-/Anfrageprotokollierung
• Manuelle API-Schlüssel-Fallback-Anmeldeinformationen

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

Checkout-Ablauf

Wenn ein Mitglied MakePay wählt, erstellt Invision eine Commerce-Transaktion und die Die Anwendung erstellt einen MakePay-Zahlungslink mit Rechnungsmetadaten.

Feld	Zweck
source=invision	Identifiziert die Integration
externalId=invision_invoice_<id>	Ordnet die MakePay-Aktivität wieder Commerce zu
invoiceId	Invision Commerce-Rechnungs-ID
transactionId	Invision Commerce-Transaktions-ID
moduleVersion	Installierte MakePay-Anwendungsversion

Das Mitglied wird zum gehosteten MakePay-Checkout weitergeleitet und kehrt zur Community zurück nach Zahlung oder Stornierung.

Handelsstaaten

Der Webhook-Endpunkt überprüft X-MakePay-Signature, bevor er Commerce ändert Transaktionsstatus.

MakePay-Status	Invision-Transaktionsstatus
paid, completed, confirmed, succeeded	Genehmigt
failed, expired	Abgelehnt
cancelled, canceled	Abgelehnt
refunded	Erstattet
Andere Status	Ausstehend

Jeder Webhook schreibt eine private Rechnungsnachricht mit dem Status MakePay, Zahlung UID und gehostete Zahlungs-URL, sofern verfügbar.

Sicherheitshinweise

Die Anwendung speichert Verbindungsdetails in verschlüsselten Invision-Einstellungen. Halten Der AdminCP-Zugriff ist auf vertrauenswürdige Betreiber beschränkt und das Gateway wird getrennt 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 Community-Basis-URL HTTPS ist und öffentlich erreichbar. Wenn die Weiterleitungen an der Kasse fehlschlagen, bestätigen Sie, dass Commerce dies tut installiert und MakePay verfügt entweder über eine gespeicherte Verbindung oder einen manuellen API-Schlüssel-Fallback Anmeldeinformationen. Wenn Rechnungen nicht aktualisiert werden, vergleichen Sie den Webhook-Callback MakePay URL mit der Community-Webhook-URL und rotieren Sie das Webhook-Geheimnis.