Referenz für Mirakl

Geplante Jobs

Onboarding

php bin/console connector:sync:onboarding -q 2>&1

• Standardeinstellung: jede Minute.
• Empfohlene Einstellung: so häufig wie möglich.
• Beschreibung: Neu erstellte Mirakl-Shops abrufen und den Onboarding-Link dem jeweiligen Mirakl-Backoffice hinzufügen.
• Dokumentation: Onboarding-Ablauf.

Validierung von Zahlungen

php bin/console connector:validate:pending-debit -q 2>&1

• Standardeinstellung: alle 5 Minuten.
• Empfohlene Einstellung: unter 1 Stunde.
• Beschreibung: Neu angenommene Mirakl-Bestellungen abrufen; die Zahlung in Mirakl validieren und bei Stripe erfassen.
• Dokumentation: Ablauf für Zahlungsvalidierung.

Aufteilung von Zahlungen

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

• Standardeinstellung: alle 5 Minuten.
• Empfohlene Einstellung: unter 1 Stunde.
• Beschreibung: Neu belastete Mirakl-Bestellungen abrufen und Stripe-Überweisungen vom Operator an den/die Verkäufer/in erstellen.
• Dokumentation: Ablauf für Zahlungsaufteilung.

Rückerstattung von Zahlungen

php bin/console connector:dispatch:process-refund -q 2>&1

• Standardeinstellung: alle 5 Minuten.
• Empfohlene Einstellung: unter 1 Stunde.
• Beschreibung: Ausstehende Mirakl-Rückerstattungen abrufen, die Rückerstattung bei Stripe erstellen, in Mirakl validieren und die ursprüngliche Überweisung zurückbuchen.
• Dokumentation: Ablauf für Zahlungsrückerstattungen.

Auszahlung

php bin/console connector:dispatch:process-payout -q 2>&1

• Standardeinstellung: jeden Tag um 1:00 Uhr.
• Empfohlene Einstellung: Synchron zu Ihren Mirakl-Abrechnungszyklen.
• Beschreibung: Rufen Sie neu erstellte Mirakl-Rechnungen auf und erstellen Sie Stripe Transfers and -Auszahlungen.
• Dokumentation: Auszahlungsablauf.

Benachrichtigungen

php bin/console connector:notify:failed-operation -q 2>&1

• Standardeinstellung: jeden Tag um 8:00 Uhr.
• Empfohlene Einstellung: Ihre bevorzugte Einstellung.
• Beschreibung: Wenn aktiviert, eine E-Mail mit sämtlichen fehlgeschlagenen Überweisungen, Rückerstattungen und Auszahlungen versenden.

Benachrichtigung

Wenn diese Funktion aktiviert ist, versendet der Connector bei folgenden Ereignissen Server-zu-Server-Benachrichtigungen.

Account updated (Konto wurde aktualisiert)

Ein verbundenes Stripe-Konto wurde durch den/die Verkäufer/in oder durch Stripe aktualisiert.

{
  "type": "account.updated",
  "payload": {
    "miraklShopId": 2000,
    "stripeUserId": "acct_1032D82eZvKYlo2C"
  }
}

Transfer failed (Überweisung fehlgeschlagen)

Während der Ausführung des Jobs für Zahlungsaufteilung oder des Jobs für Auszahlungen ist eine Überweisung fehlgeschlagen.

{
  "type": "transfer.failed",
  "payload": {
    "internalId": 5,
    "miraklId": 123,
    "type": "TRANSFER_ORDER",
    "stripeAccountId": "acct_1032D82eZvKYlo2C",
    "miraklShopId": 2003,
    "transferId": null,
    "transactionId": null,
    "amount": 3400,
    "status": "TRANSFER_FAILED",
    "failedReason": "Reason message",
    "currency": "EUR"
  }
}

Refund failed (Rückerstattung fehlgeschlagen)

Während der Ausführung des Jobs für Zahlungsrückerstattungen ist eine Rückerstattung fehlgeschlagen.

{
  "type": "refund.failed",
  "payload": {
    "internalId": 5,
    "miraklOrderId": "order_refunded_5",
    "miraklRefundId": "1100",
    "stripeRefundId": null,
    "stripeReversalId": "trr_10",
    "amount": 3400,
    "status": "REFUND_FAILED",
    "failedReason": "Reason message",
    "currency": "EUR"
  }
}

Payout failed (Auszahlung fehlgeschlagen)

Während der Ausführung des Jobs für Auszahlungen ist eine Auszahlung fehlgeschlagen.

{
  "type": "payout.failed",
  "payload": {
    "internalId": 12,
    "amount": 2300,
    "currency": "EUR",
    "miraklInvoiceId": 2000,
    "stripePayoutId": null,
    "status": "PAYOUT_FAILED",
    "failedReason": "Reason message",
  }
}