Installation des Mirakl-Plugins

Installieren und validieren Sie das Mirakl-Plugin für Stripe.

Voraussetzungen

Zum Installieren und Ausführen der Anwendung ist Folgendes erforderlich:

PHP 7.3+
PostgreSQL
Ein Webserver, Nginx wird empfohlen
Ein gültiges SSL/TLS-Zertifikat
Supervisord oder vergleichbar
Crontab oder vergleichbar

Mithilfe von Docker installieren

Sie können die Anwendung erstellen und starten, indem Sie sie in einen Container einbetten. In unserem Docker-Beispiel finden Sie weitere Informationen.

Manuell installieren

Installieren Sie Composer.
Kopieren Sie die Mirakl-App oder laden Sie sie von GitHub herunter.
Verschieben Sie den Inhalt in das Webserver-Verzeichnis, z. B. /var/www.
Laden Sie Abhängigkeiten herunter:

Command Line
composer install --prefer-dist --no-dev

Stellen Sie sicher, dass die ENV-Datei ordnungsgemäß konfiguriert ist.
Führen Sie die Migrationen aus, um die Datenbank einzurichten:

Command Line

bin/console doctrine:migration:migrate --no-interaction

Wenn in dieser Phase Fehler auftreten, überprüfen Sie die Variable DATABASE_URL in Ihrer .env-Datei.

Aktualisieren Sie den Supervisor, um die Worker automatisch zu starten und neu zu starten.

Ein Konfigurationsbeispiel finden Sie in unserem Docker-Beispiel. In einer Entwicklungsumgebung können Sie diesen Schritt überspringen und die Worker bei Bedarf manuell starten:

Command Line
php bin/console messenger:consume process_transfers --time-limit=3600 --env=prod

Aktualisieren Sie Ihren Job-Scheduler, um die Befehle regelmäßig auszuführen.

Ein Konfigurationsbeispiel finden Sie in unserem Docker-Beispiel. In einer Entwicklungsumgebung können Sie diesen Schritt überspringen und die Jobs bei Bedarf manuell starten:

Command Line
php bin/console connector:dispatch:process-transfer -q 2>&1

Stellen Sie sicher, dass Ihr Webserver so konfiguriert ist, dass das Verzeichnis public als Dokumenten-Stammverzeichnis verwendet wird.

Installation prüfen

Öffnen Sie Ihr Terminal und führen Sie folgenden Befehl aus, um zu prüfen, ob Ihre Anwendung korrekt ausgeführt wird:

Command Line
curl -X GET "https://app-url/api/mappings" \
  -H "accept: application/json" \
  -H "X-AUTH-TOKEN: $OPERATOR_PASSWORD
"

Sie sollten den Antwortcode 200 zusammen mit einer leeren Nutzlast erhalten.

Sicherheit

Schränken Sie auf Ihrem Server den gesamten eingehenden Datenverkehr zum Plugin ein, mit Ausnahme der folgenden Endpoints:

/api/public/onboarding/refresh
Stripe leitet die Verkäufer/innen am Ende des Onboardings zu dieser URL weiter, um einen neuen Onboarding-Link zu erhalten, wenn er abläuft.
/api/public/webhook/operator
Stripe benachrichtigt diesen Endpoint, wenn eine Zahlung aktualisiert wird, damit sie einer Mirakl-Bestellung in der App zugeordnet werden kann.
/api/public/webhook/sellers
Stripe benachrichtigt diesen Endpoint, wenn ein Stripe-Konto aktualisiert wird, damit der Status des Verkäufers/der Verkäuferin innerhalb der App synchronisiert werden kann.

Diese Endpoints können bedenkenlos bereitgestellt werden, da sie jeweils einen internen Schutzmechanismus haben. Andere Endpoints sollten aus Sicherheitsgründen nicht bereitgestellt werden, wenn sie nicht durch ein starkes OPERATOR_PASSWORD geschützt sind.

Siehe auch

Integrationsschritte.