Wix Velo-Gateway

Überblick

MakePay für Wix verwendet das Payment Provider-Dienst-Plugin von Wix Velo. Der Kaufmann fügt dem Wix-Editor vier MakePay-JavaScript-Dateien hinzu, installiert crypto-js, verbindet den Zahlungsanbieter unter Einstellungen > Zahlungen akzeptieren und speichert die API Geheimnisse im Wix Secrets Manager.

An der Kasse nennt Wix createTransaction(). Die Backend-Datei MakePay wird erstellt einen gehosteten MakePay-Zahlungslink und gibt die Weiterleitungs-URL an Wix zurück. Wenn MakePay Bestätigt die Zahlung, ein signierter Webhook ruft die HTTP-Funktion von Wix und den Code auf erfasst die Zahlung auf der Wix-Bestellung.

Bevor Sie beginnen

Sie benötigen:

• Ein Wix-Store mit aktiviertem Entwicklermodus
• Berechtigung zum Bearbeiten von Velo-Backend-Dateien und Service-Plugins
• Berechtigung zur Nutzung von Wix Secrets Manager
• Ein MakeCrypto-Unternehmen mit konfigurierter MakePay-Abrechnung
• Ein MakePay-API-Schlüssel mit Schreibzugriff auf den Zahlungslink
• Ein MakePay-Webhook-Geheimnis für das Unternehmen

Erstellen Sie MakePay-Anmeldeinformationen

In MakeCrypto:

1. Wählen Sie das Unternehmen aus, das Zahlungen von Wix erhalten soll.
2. Öffnen Sie Wallet > Guthaben und konfigurieren Sie die Abrechnung.
3. Öffnen Sie Integrationen > API-Integrationen und erstellen Sie einen API-Schlüssel.
4. Geben Sie mindestens den Schlüssel an:
   • makepay:payment-links:read
   • makepay:payment-links:write
5. Kopieren Sie die Unternehmens-ID, die API-Schlüssel-ID und das API-Schlüsselgeheimnis.
6. Öffnen Sie Händler > Zahlungseinstellungen und rotieren oder kopieren Sie das Webhook-Geheimnis.

Das API-Schlüsselgeheimnis und das Webhook-Geheimnis werden zum Wix Secrets Manager hinzugefügt, nicht zu Frontend-Code.

Wix Velo-Dateien hinzufügen

Öffnen Sie das Quell-Repository MakePay von Wix:

https://github.com/makecryptoio/makepay-wix

Die gleiche Quelle wird in diesem Monorepo unter apps/plugins/wix verwaltet.

Bei Wix:

1. Öffnen Sie den Site-Editor und aktivieren Sie den Dev-Modus.
2. Erstellen Sie unter Öffentlich & Backend > Backend Folgendes:
   • MakePay.js
   • http-functions.js
3. Erstellen Sie unter Service-Plugins ein Zahlungs-Plugin mit dem Namen MakePayPayment.
4. Kopie:
   • MakePayPayment-config.js
   • MakePayPayment.js
5. Installieren Sie das npm-Paket crypto-js von Pakete & Apps.
6. Veröffentlichen Sie die Website.

Wix-Geheimnisse hinzufügen

Öffnen Sie Entwicklertools > Secrets Manager und fügen Sie Folgendes hinzu:

Geheimer Name	Wert
makepay_api_key_secret	Das API-Schlüsselgeheimnis MakePay
makepay_webhook_secret	Das Webhook-Geheimnis MakePay

Fügen Sie diese Werte nicht in Seitencode oder öffentliche Frontend-Dateien ein.

Verbinde MakePay in Wix

Öffnen Sie Einstellungen > Zahlungen akzeptieren im Wix-Dashboard und verbinden Sie den benutzerdefinierten Link MakePay Zahlungsanbieter.

Eingeben:

Feld	Wert
MakePay Firmen-ID	Die Firmen-ID MakeCrypto
MakePay API-Schlüssel-ID	Die API-Schlüssel-ID MakePay
Abrechnungswährung	Normalerweise USDT

Der Titel der Zahlungsmethode „Checkout“ lautet:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Konfigurieren Sie Webhooks

Der HTTP-Funktionsendpunkt von Wix ist:

https://your-wix-domain.com/_functions/makepay_notify

Öffnen Sie in MakeCrypto Händler > Zahlungseinstellungen und legen Sie den Rückruf MakePay fest URL zu diesem Endpunkt. Das Webhook-Geheimnis im Wix Secrets Manager muss mit dem übereinstimmen MakePay Webhook-Geheimnis.

Der Webhook-Handler von Wix überprüft zuvor den Header X-MakePay-Signature markiert jede Bestellung als bezahlt.

Testen Sie die Kaufabwicklung

1. Fügen Sie Ihrem Wix-Warenkorb ein Produkt mit geringem Wert hinzu.
2. Gehen Sie zur Kasse.
3. Wählen Sie die Krypto-Zahlungsmethode MakePay.
4. Klicken Sie auf Bestellung aufgeben und bezahlen.
5. Bestätigen Sie, dass Wix zum gehosteten MakePay-Checkout weiterleitet.
6. Führen Sie eine Testzahlung durch.
7. Bestätigen Sie, dass die Wix-Bestellung nach Erhalt des Webhooks als bezahlt markiert ist.
8. Überprüfen Sie Integrationen > Webhook-Anfragen in MakeCrypto, wenn die Bestellung dies tut nicht aktualisieren.

Sicherheitshinweise

Die Wix-Integration verwendet eine API-Schlüsselauthentifizierung, da Velo vom Händler kopiert wurde Zahlungsanbieterdateien unterstützen den automatischen Ablauf Connect MakePay nicht noch.

Halten Sie diese Regeln ein:

• Speichern Sie Geheimnisse nur im Wix Secrets Manager.
• Verwenden Sie einen MakePay-spezifischen API-Schlüssel, keinen breiten internen Schlüssel.
• Gewähren Sie keine Wallet-Send- oder API-Key-Management-Bereiche.
• Rotieren Sie den API-Schlüssel und das Webhook-Geheimnis, wenn jemand Zugriff auf den alten Wix-Editor hat sollte keine Zahlungen mehr verwalten.
• Halten Sie die Rückruf-URL HTTPS und öffentlich.

Fehlerbehebung

Wenn der Anbieter nicht unter Zahlungen akzeptieren erscheint, bestätigen Sie, dass der Dienst verfügbar ist Das Plugin heißt MakePayPayment, die beiden Plugin-Dateien sind vorhanden und die Site verfügt über wurde nach dem Hinzufügen von Code veröffentlicht.

Wenn Connect fehlschlägt, bestätigen Sie, dass makepay_api_key_secret in Wix vorhanden ist Secrets Manager und dass die API-Schlüssel-ID/Unternehmens-ID mit demselben MakeCrypto übereinstimmen Unternehmen.

Wenn der Checkout nicht umgeleitet wird, überprüfen Sie die Wix Velo-Protokolle auf createTransaction Fehler und bestätigen Sie, dass der API-Schlüssel makepay:payment-links:write hat.

Wenn Bestellungen nicht aktualisiert werden, bestätigen Sie, dass die Rückruf-URL MakeCrypto lautet https://your-wix-domain.com/_functions/makepay_notify, das Webhook-Geheimnis stimmt überein und die Webhook-Zustellungsprotokolle MakeCrypto zeigen eine 2xx-Antwort.