MakePay Blesta-Gateway

Über das offizielle Blesta-Gateway MakePay können Kunden Blesta-Rechnungen bezahlen gehosteter Krypto-Checkout. Blesta erstellt und besitzt die Rechnung. MakePay erstellt die Checkout-Link und sendet Zahlungsaktualisierungen zurück an Blesta.

Die wiederkehrende Abrechnung bleibt innerhalb von Blesta. Wenn Blesta eine Verlängerungsrechnung erstellt, Das Gateway behandelt die Zahlung wie jede andere Rechnungszahlung.

Bevor Sie beginnen

Sie benötigen:

• Blesta 5.x oder neuer
• HTTPS Blesta-Installation
• Administratorzugriff auf Blesta-Zahlungsgateways
• MakePay-Abrechnung und Branding konfiguriert

Installieren Sie das Gateway

Laden Sie das neueste Paket herunter:

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

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

Blesta/components/gateways/nonmerchant/makepay

Öffnen Sie in Blesta Einstellungen > Zahlungsgateways, wählen Sie Verfügbar und suchen Sie MakePay und installieren Sie es als Nicht-Händler-Gateway.

Schließen Sie MakePay an

Öffnen Sie die MakePay-Gateway-Einstellungen in Blesta und klicken Sie auf MakePay verbinden.

Der Verbindungsablauf:

1. Öffnet die MakePay-Verbindungsseite.
2. Hier können Sie das Unternehmen auswählen, das Zahlungen erhalten soll.
3. Bringt Sie nach Genehmigung nach Blesta zurück.
4. Speichert die Gateway-Verbindung für diese Blesta-Installation.

Erstellen Sie nach der Verbindung eine kleine Testrechnung und bezahlen Sie diese im Kundenbereich.

Manueller API-Schlüssel-Fallback

Connect MakePay ist die empfohlene Konfiguration. Die manuelle Einrichtung des API-Schlüssels ist verfügbar für Geschäfte, die die geführte Verbindung nicht abschließen können.

Stellen Sie für die manuelle Einrichtung die Verbindungsmethode auf Manueller API-Schlüssel ein und geben Sie Folgendes ein:

• MakePay Firmen-ID
• API-Schlüssel-ID
• API-Schlüsselgeheimnis
• Webhook-Signaturgeheimnis

Sorgen Sie dafür, dass die in Blesta angezeigte Rückruf-URL über das öffentliche Internet erreichbar ist.

Checkout-Ablauf

Wenn ein Kunde MakePay für eine Blesta-Rechnung wählt, führt das Gateway Folgendes aus:

1. Liest den Rechnungsbetrag, die Währung, die Kunden-ID und die Rechnungsmetadaten.
2. Erstellt einen gehosteten MakePay-Zahlungslink.
3. Zeigt die Schaltfläche Bezahlen mit MakePay an.
4. Leitet den Kunden zum gehosteten Checkout weiter.
5. Erhält einen signierten Rückruf, wenn sich der Zahlungsstatus ändert.

Der Zahlungslink enthält Metadaten wie:

Feld	Zweck
source=blesta	Identifiziert die Integration
orderId=blesta_invoice_<invoiceId>	Ordnet die MakePay-Aktivität zurück zu Blesta
invoiceId	Primäre Blesta-Rechnungs-ID
clientId	Blesta-Kunden-ID, sofern verfügbar

Rechnungszustände

MakePay-Status	Blesta-Verhalten
paid, completed, confirmed, succeeded	Zeichnet eine genehmigte Transaktion auf
pending, waiting, confirming	Hält die Zahlung ausstehend
failed, expired, cancelled	Zeichnet eine abgelehnte Zahlung auf

Blesta bleibt für die Aktivierung des Dienstes und die wiederkehrende Abrechnung verantwortlich Automatisierung nach Bezahlung der Rechnung.

Sicherheitshinweise

Verwenden Sie HTTPS, beschränken Sie den Blesta-Administratorzugriff und trennen Sie das Gateway über das MakePay-Dashboard, wenn ein Administratorkonto oder eine Serversicherung vorhanden ist ausgesetzt. Stellen Sie die Verbindung wieder her, nachdem Sie die Blesta-Domain geändert haben, also Rückruf- und Rückgabe-URLs zur Live-Installation passen.

Fehlerbehebung

Wenn Connect MakePay nicht gestartet werden kann, bestätigen Sie, dass die Blesta-Rückruf-URL öffentlich ist und das Gateway ist als Nicht-Händler-Gateway installiert.

Wenn Rechnungen nicht aktualisiert werden, überprüfen Sie, ob die in den Einstellungen angezeigte Rückruf-URL korrekt ist erreichbar ist und dass das Webhook-Signaturgeheimnis vorhanden ist.

Wenn Clients einen Checkout-Fehler sehen, bestätigen Sie, dass MakePay verbunden und ausgewählt ist Die Rechnungswährung wird von Ihrem MakePay-Setup unterstützt.