Installieren Sie die Mirakl-App

Richten Sie die Miraki-App für Stripe ein.

Zum Installieren und Ausführen der Mirakl-App müssen Sie die folgenden Anforderungen erfüllen:

PHP 7.3+
PostgreSQL
Ein Webserver (Nginx wird empfohlen)
Ein gültiges SSL- oder TLS-Zertifikat
Supervisord oder ein gleichwertiger Prozess-Manager
Crontab oder ein gleichwertiger Aufgabenplaner

Verwendung von Docker

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

Composer verwenden

Installieren Sie Composer.
Klonen Sie die Datei oder laden Sie die Mirakl-App 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
```
Konfigurieren Sie die [.env-Datei] ordnungsgemäß.](/use-stripe-apps/mirakl/configuration).
Führen Sie die Migrationen aus, um die Datenbank einzurichten. Wenn zu diesem Zeitpunkt Fehler auftreten, überprüfen Sie die Schaltfläche DATABASE_URL in Ihrer .env-Datei.
Command Line
```
bin/console doctrine:migration:migrate --no-interaction
```
Aktualisieren Sie Ihr Hauptsteuerprogramm, um die Worker-Instanzen automatisch zu starten und neu zu starten. Ein Konfigurationsbeispiel ist in unserem Docker-Beispiel verfügbar. Sie können diesen Schritt in einer Entwicklungsumgebung überspringen und die Worker bei Bedarf manuell starten, z. B.:
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 ist in unserem Docker-Beispiel verfügbar. Sie können diesen Schritt in einer Entwicklungsumgebung überspringen und die Aufträge bei Bedarf manuell starten, z. B.:
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.

Ihre Installation testen

Ö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.

Einschränken des eingehenden Datenverkehrs

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 die/den Verkäufer/in auf diese URL weiter, um einen neuen Onboarding Link zu erhalten, wenn dieser abläuft.
/api/public/webhook/operator: Stripe benachrichtigt diesen Endpoint, wenn eine Zahlung aktualisiert wird, um sie mit einer Mirakl-Bestellung innerhalb der App zu verknüpfen.
/api/public/webhook/sellers: Stripe benachrichtigt diesen Endpoint, wenn ein Stripe-Konto aktualisiert wird, um den Status der Verkäuferin / des Verkäufers innerhalb der App zu synchronisieren.

Diese Endpoints können sicher verfügbar gemacht werden, da sie jeweils über einen internen Schutzmechanismus verfügen. Andere Endpoints können nicht sicher verfügbar gemacht werden, es sei denn, sie sind durch ein starkes OPERATOR_PASSWORD geschützt.