PrestaShop-Modul

Überblick

Mit MakePay für PrestaShop können Händler Krypto-Zahlungen über Hosting akzeptieren MakePay Kasse. Kunden wählen währenddessen die Zahlungsart MakePay PrestaShop-Kaufvorgang, werden zum Bezahlen zu MakePay weitergeleitet und kehren zum Geschäft zurück nach Bezahlung.

Das Modul erstellt für jede PrestaShop-Bestellung einen MakePay-Zahlungslink und lauscht für signierte MakePay-Webhooks, sodass Änderungen des Bestellstatus automatisch erfolgen.

Bevor Sie beginnen

Sie benötigen:

• PrestaShop 8.0 oder neuer, einschließlich PrestaShop 9.x
• PHP 7.4 oder neuer mit aktiviertem OpenSSL
• Eine HTTPS-Backoffice- und Checkout-URL
• Ein PrestaShop-Mitarbeiterkonto, das Module konfigurieren kann
• Ein MakeCrypto-Unternehmen mit konfigurierter MakePay-Abrechnung

PHP-Natrium wird empfohlen. Wenn es verfügbar ist, verwendet das Modul es mit PrestaShop-Cookie-Geheimnisse zum Verschlüsseln von Verbindungsdetails, Webhook-Geheimnissen usw manuelle API-Schlüssel-Fallback-Anmeldeinformationen.

Richten Sie MakeCrypto ein

Schließen Sie die Händlereinrichtung ab, bevor Sie PrestaShop verbinden.

1. Melden Sie sich bei https://www.makecrypto.io an und wählen Sie das Unternehmen, das PrestaShop-Zahlungen erhalten soll.
2. Öffnen Sie Wallet > Guthaben und konfigurieren Sie dann die Abrechnungswährung, -kette usw Ziel-Wallet.
3. Öffnen Sie Händler > Zahlungseinstellungen und überprüfen Sie die Zahlungsgebühr und die Weiterleitung Verhalten.
4. Optional: Öffnen Sie Einstellungen > Händler, um Händler-Branding und Support hinzuzufügen E-Mail, Checkout-Farben, gehostetes Zahlungsdesign und benutzerdefinierte Domains.

Sie müssen eine Entwickleranwendung nicht manuell erstellen. Der Beamte Das PrestaShop-Modul erstellt beim Klicken eine geschäftsspezifische Verbindung Verbinden Sie MakePay.

Installieren Sie das Modul

Laden Sie die neueste offizielle Modul-ZIP-Datei herunter:

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

Dann installieren Sie es in PrestaShop:

1. Öffnen Sie Back Office > Module > Modulmanager.
2. Klicken Sie auf Modul hochladen und wählen Sie das heruntergeladene makepay.zip aus.
3. Klicken Sie nach der Installation auf Konfigurieren.
4. Behalten Sie für die Authentifizierung den standardmäßigen Verbindungsmodus bei.

Das ZIP-Stammverzeichnis ist makepay/ und die Hauptmoduldatei ist entsprechend makepay.php Erwartungen an die Verpackung des PrestaShop-Moduls.

Vernetzen Sie Ihren Shop

Verwenden Sie Connect MakePay für die normale Einrichtung. Es verknüpft diesen PrestaShop-Shop mit dem MakeCrypto Unternehmen, das Sie auswählen, und können später ohne Änderung getrennt werden Geschäftscode.

1. Behalten Sie in der MakePay-Modulkonfiguration die Einstellung MakePay API-Basis-URL bei https://www.makecrypto.io.
2. Klicken Sie auf MakePay verbinden.
3. Melden Sie sich bei Aufforderung bei MakeCrypto an, wählen Sie das von Ihnen vorbereitete Unternehmen aus und den beantragten Zugang genehmigen.
4. Bestätigen Sie nach der Rückkehr zu PrestaShop, dass das Modul den Shop als anzeigt verbunden.
5. Speichern Sie die Gateway-Einstellungen und lassen Sie das Modul aktiviert.

Während der Verbindung registriert das Modul automatisch die öffentliche Webhook-URL:

https://your-store.example/module/makepay/webhook

Sorgen Sie dafür, dass dieser Endpunkt über das öffentliche Internet erreichbar ist. Sicherheitsmodule, Firewalls und Caching-Regeln sollten signierte POST-Anfragen an diese URL zulassen.

So funktioniert die Verbindung

Die Schaltfläche MakePay verbinden öffnet MakeCrypto in einem Browser-Tab. Sie melden sich an, Wählen Sie das Unternehmen aus, das Zahlungen erhalten soll, überprüfen Sie den angeforderten Zugang, und nach der Genehmigung an PrestaShop zurücksenden. Das Modul speichert dann die Verbindung, Registriert die Webhook-URL und hält die Einstellungen für jeden Shop-Kontext in getrennt Multistore-Installationen.

Für PrestaShop ist kein gemeinsames App-Geheimnis oder die Einrichtung einer Entwickler-App erforderlich.

Gateway-Einstellungen

Überprüfen Sie diese Einstellungen unter Module > Modulmanager > MakePay > Konfigurieren.

Einstellung	Was es bewirkt
Ermöglicht	Schaltet die Zahlungsmethode MakePay an der Kasse ein oder aus.
Authentifizierung	Verwenden Sie für normale Installationen den standardmäßigen Verbindungsmodus. Manueller API-Schlüssel-Fallback dient der vom Support unterstützten Wiederherstellung.
Name der Zahlungsmethode	Der Name, den Kunden an der Kasse sehen, zum Beispiel Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others.
Checkout-Erlebnis	Verwenden Sie gehostete Weiterleitung für den zuverlässigsten Ablauf oder eingebettete Checkout-Seite, um MakePay auf einer sicheren Iframe-Seite mit einem gehosteten Link-Fallback anzuzeigen.
Abrechnungswährung	Bevorzugtes MakePay-Asset wie USDT. MakePay löst die Kette nach Möglichkeit aus den Unternehmenseinstellungen auf.
Zahlungsablauf	Lebensdauer des gehosteten Checkouts, zum Beispiel 30m, 2h oder 12h.
MakePay API-Basis-URL	Verwenden Sie https://www.makecrypto.io für die Produktion.
Firmen-ID/API-Schlüssel-ID/API-Schlüsselgeheimnis	Nur für manuelles API-Schlüssel-Fallback erforderlich.
Webhook-Geheimnis	Wird während der Verbindung automatisch eingestellt. Nur für den Fallback-Modus manuell eingeben.

Auftragszustände

Beim Auschecken erstellt das Modul eine PrestaShop-Bestellung im Benutzerdefiniert Status Warten auf MakePay-Zahlung und öffnet den ausgewählten MakePay-Checkout Erfahrung.

Webhook-Statuszuordnung:

MakePay-Status	PrestaShop-Status
paid, completed, confirmed, succeeded	Zahlung akzeptiert
refunded, refund	Erstattet
failed, expired, chargeback	Zahlungsfehler
cancelled, canceled	Abgesagt
andere laufende Status	Warten auf die Zahlung von MakePay

Das Modul schreibt private Bestellnachrichten mit Webhook-Status, Zahlungs-UID, Betrag, Vermögenswert und Zahlungs-URL, sofern in der Webhook-Nutzlast MakePay vorhanden.

Sicherheit und Berechtigungen

Die PrestaShop-Verbindungsanforderungen:

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

Es kann keine Wallet-Gelder senden oder alte API-Schlüssel erstellen.

Webhook-Updates werden von MakePay signiert und vor jeder PrestaShop-Bestellung überprüft Zustandsänderungen. Store-Administratoren können die Verbindung in MakeCrypto widerrufen unter Integrationen > Verbundene Apps oder trennen Sie es vom PrestaShop Modulkonfigurationsseite.

Manueller API-Schlüssel-Fallback

Verwenden Sie den manuellen API-Schlüsselmodus nur, wenn Connect MakePay nicht verfügbar ist oder MakeCrypto Der Support bittet Sie, es zu verwenden.

1. Öffnen Sie in MakeCrypto Integrationen > API-Integrationen.
2. Erstellen oder wählen Sie einen MakePay-API-Schlüssel für dasselbe Unternehmen, das den Store erhält Zahlungen.
3. Kopieren Sie die Unternehmens-ID, die API-Schlüssel-ID, das API-Schlüsselgeheimnis und das Webhook-Geheimnis.
4. Öffnen Sie in PrestaShop Module > Modulmanager > MakePay > Konfigurieren.
5. Setzen Sie Authentifizierung auf Manueller API-Schlüssel-Fallback.
6. Fügen Sie die Anmeldeinformationen ein und speichern Sie.

Halten Sie API-Schlüsselgeheimnisse von Designdateien, clientseitigen Skripts und der Öffentlichkeit fern support tickets. Connect MakePay wird weiterhin für normale Geschäfte bevorzugt Betrieb.

Fehlerbehebung

Wenn Connect MakePay fehlschlägt, bestätigen Sie, dass Ihre Backoffice-URL HTTPS verwendet. Ihr Shop kann ausgehende HTTPS-Anfragen an https://www.makecrypto.io stellen und Das Mitarbeiterkonto kann Module konfigurieren.

Wenn die Zahlungsmethode beim Bezahlen nicht angezeigt wird, bestätigen Sie, dass das Modul vorhanden ist aktiv, Aktiviert ist eingeschaltet und der Store ist mit MakePay verbunden oder verfügt über gültige manuelle API-Schlüssel-Anmeldeinformationen.

Wenn beim Bezahlen ein Abrechnungs- oder Onboarding-Fehler angezeigt wird, kehren Sie zu MakeCrypto zurück und schließen Sie Wallet > Guthaben > Abrechnung einrichten für das verbundene Unternehmen des Shops ab.

Wenn Bestellungen nach der Zahlung nicht aktualisiert werden, überprüfen Sie Integrationen > Webhook-Anfragen in MakeCrypto für Zustellversuche. Der PrestaShop-Webhook-Endpunkt sollte eine 2xx-Antwort zurückgeben. Überprüfen Sie außerdem, dass Hosting-Firewalls nicht blockieren POST-Anfragen an /module/makepay/webhook.

Wenn Sie die Shop-Domain oder Back-Office-Domain ändern oder den Shop in eine neue verschieben Umgebung, trennen und verbinden Sie MakePay erneut, sodass der Verbindungsrückruf und der Webhook erfolgt URLs stimmen mit dem aktuellen Shop überein.