Installation des Mirakl Connectors

Installieren und validieren Sie den Mirakl-Connector for 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 den Mirakl Connector von GitHub oder laden Sie ihn von dort 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://connector-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 Connector 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 innerhalb des Connectors zugeordnet werden kann.
/api/public/webhook/sellers
Stripe benachrichtigt diesen Endpoint, wenn ein Stripe-Konto aktualisiert wird, damit der Status der Verkäuferin/des Verkäufers innerhalb des Connectors 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.