MakePay Magento-Modul

Überblick

Das offizielle Magento-Modul MakePay fügt eine gehostete Krypto-Checkout-Methode hinzu Magento Open Source- und Adobe Commerce 2.4.x-Stores. Magento erstellt die Bestellung, MakePay erstellt den gehosteten Zahlungslink und signierte Webhooks aktualisieren die Bestellung nachdem sich der Zahlungsstatus geändert hat.

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

Bevor Sie beginnen

• Magento Open Source oder Adobe Commerce 2.4.x
• PHP 8.1 oder neuer
• Administratorzugriff auf Stores > Konfiguration > Verkäufe > Zahlungsmethoden
• Ein MakePay-Unternehmen, bei dem Sie Zahlungseinstellungen verwalten können

Installieren Sie das Modul

Laden Sie die neueste ZIP-Datei herunter:

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

Extrahieren Sie das Paket, sodass sich das Modul unter folgender Adresse befindet:

app/code/MakePay/Payment

Aktivieren Sie es von Ihrem Magento-Root aus:

bin/magento module:enable MakePay_Payment
bin/magento setup:upgrade
bin/magento cache:clean

Schließen Sie MakePay an

Öffnen Sie Stores > Konfiguration > Verkäufe > Zahlungsmethoden > MakePay und wählen Sie Schließen Sie MakePay an. Das Modul:

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 Magento-Modul benötigten Berechtigungen an.
4. Bringt Sie nach der Genehmigung zurück zu Magento.
5. Speichert die Store-Verbindung in einer Magento-verschlüsselten Konfiguration.
6. Konfiguriert den Webhook-Rückruf und das Webhook-Geheimnis MakePay.

Konfigurieren Sie MakePay

Nachdem die Verbindung hergestellt wurde, behalten Sie für die Verbindungsmethode die Standardeinstellung „Verbindung“ bei Modus. Aktivieren Sie die Zahlungsart und Bewertung:

• Name der Zahlungsmethode
• Checkout-Erlebnis
• Abrechnungswährung
• Ablauf des Zahlungslinks
• Status der ausstehenden, bezahlten, fehlgeschlagenen, stornierten und erstatteten Bestellung

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

Checkout-Ablauf

Wenn ein Kunde MakePay wählt, platziert Magento die Bestellung in der Warteschleife. Anschließend wird das ausgewählte MakePay-Checkout-Erlebnis geöffnet. Gehostete Weiterleitung ist die empfohlene Standardeinstellung; Der eingebettete Checkout zeigt eine sichere MakePay-Iframe-Seite mit einem Fallback für gehostete Links.

Die Nutzlast des Zahlungslinks umfasst:

Feld	Zweck
source=magento	Identifiziert die Integration
orderId=magento_order_<id>	Ordnet die MakePay-Aktivität zurück zu Magento zu
incrementId	Für Menschen lesbare Magento-Bestellnummer
magentoOrderAdminUrl	Ermöglicht MakeCrypto, Administratoren wieder mit der Magento-Bestellung zu verknüpfen
moduleVersion	Installierte Modulversion MakePay
magentoVersion	Magento- oder Adobe Commerce-Laufzeitversion

Bestellstaaten

Der Webhook-Endpunkt ist /makepay/webhook/index. Es überprüft die X-MakePay-Signature-Header vor dem Aktualisieren einer Bestellung.

MakePay-Status	Magento-Status
paid, completed, confirmed, succeeded	Verarbeitung
failed, expired	Abgesagt
cancelled, canceled	Abgesagt
refunded	Geschlossen
Andere Status	Ausstehende Zahlung

Jeder Webhook schreibt einen privaten Kommentar zur Bestellhistorie mit dem Zahlungsstatus. öffentliche MakePay-Checkout-URL, MakeCrypto-Dashboard-URL und verfügbares MakePay Bezeichner.

Sicherheitshinweise

Das Modul speichert Verbindungsdetails in einer Magento-verschlüsselten Konfiguration. Halten Der Magento-Administratorzugriff ist auf vertrauenswürdige Betreiber beschränkt und der Store 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 Magento-Basis-URL HTTPS ist und öffentlich erreichbar. Wenn die Weiterleitung des Checkouts fehlschlägt, überprüfen Sie, ob das Modul aktiviert ist und MakePay verfügt entweder über eine gespeicherte Verbindung oder einen manuellen API-Schlüssel-Fallback Anmeldeinformationen. Wenn Bestellungen nicht aktualisiert werden, vergleichen Sie die Webhook-Rückruf-URL in MakePay-Einstellungen mit der Magento-/makepay/webhook/index-URL und drehen Sie die Webhook-Geheimnis.