← Alle Beiträge

Mollie in Shopware 6: „createCapture failed, skipping shipment“ – was mit dem autorisierten Geld passiert

Mollie in Shopware 6: „createCapture failed, skipping shipment“ – was mit dem autorisierten Geld passiert

Du setzt eine Bestellung in der Administration auf „Versandt“, der Status springt brav um, keine Fehlermeldung. Im Mollie-Log steht derweil AuthorizationReconciler: Mollie createCapture failed, skipping shipment oder, bei älteren Plugin-Versionen, ShipOrderRoute: Mollie createCapture failed, skipping shipment. Das Mollie-Plugin wollte beim Versand das Geld einziehen und hat es nicht geschafft. Ob das egal ist oder ob dir gerade eine Zahlung durch die Finger rutscht, hängt davon ab, wie die Zahlung bei Mollie dasteht.

Die Fehlermeldung

So sieht der Eintrag aus, gekürzt und anonymisiert:

AuthorizationReconciler: Mollie createCapture failed, skipping shipment {
  "orderNumber": "<Bestellnummer>",
  "orderId": "<orderId>",
  "requestedItems": [],
  "orderLineItems": { "<lineItemId>": { "label": "<Artikel>", "quantity": 1, "shippedQty": 0 } },
  "fullyShipped": true,
  "molliePaymentId": "tr_<id>",
  "exception": "<Antwort der Mollie-API>"
}

Die Variante mit ShipOrderRoute: am Anfang hat denselben Aufbau. Wichtig sind drei Felder: molliePaymentId (die tr_-ID der Zahlung bei Mollie), fullyShipped und exception. In exception steht, was Mollie geantwortet hat. Je nachdem, wie dein Log-Viewer lange Zeilen abschneidet, siehst du dieses Feld nur in der Rohdatei.

Was dahintersteckt

Manche Zahlarten buchen das Geld beim Kauf nicht ab, sondern reservieren es nur. Bei Mollie heißt das captureMode: manual: Die Zahlung geht auf den Status authorized, und erst ein Capture holt das Geld tatsächlich ein. Im Plugin können das Klarna, Billie, Riverty, Billink, Kreditkarte, MobilePay und Vipps sein. Riverty und Billink reservieren immer, bei den anderen entscheidest du seit 5.6.0 im Abschnitt „Authorization and capture“ pro Zahlart und Verkaufskanal, ob stattdessen direkt abgebucht wird.

Den Capture löst das Plugin beim Versand aus. Wenn in der Plugin-Konfiguration „Automatischer Versand“ aktiv ist, reagiert ein Subscriber auf den Lieferstatus-Übergang „ship“ und ruft die Versand-Route auf. Derselbe Weg läuft über die Flow-Builder-Aktion, den Button im Mollie-Tab der Bestellung und die Shipment-API, die zum Beispiel ein ERP anspricht. Bei Zahlungen über die Payments API (IDs mit tr_) schickt das Plugin dann POST payments/{id}/captures an Mollie.

Scheitert dieser Aufruf, fängt das Plugin die Exception ab, schreibt genau diese Log-Zeile und bricht ab. Der Code-Kommentar dazu sagt es offen: Der Capture kann scheitern, etwa weil die Zahlung schon eingezogen wurde, und das darf den Statuswechsel nicht unterbrechen. Die Folge:

  • In Shopware steht die Lieferung auf „Versandt“.
  • Das Plugin speichert weder eine Capture-ID noch die versendeten Mengen an den Positionen.
  • Bei Mollie hat sich nichts geändert.

Wo der Text herkommt, hängt von der Version ab. In 5.3.0 saß der Capture direkt in ShipOrderRoute. Laut Changelog brauchte der automatische Versand ab dieser Version keine autorisierte Zahlung mehr, damit manuell auf „bezahlt“ gesetzte Bestellungen trotzdem versendet werden. Im Code von 5.3.0 gibt es vor dem Capture keine Prüfung, ob die Zahlart überhaupt reserviert. Ab 5.4.0 liegt die Logik in AuthorizationReconciler, und der prüft vorher zwei Dinge: ob die Zahlart überhaupt manuell captured wird und ob bei Mollie noch ein offener, nicht eingezogener Betrag existiert. Fehlt eins davon, gibt es nur einen Debug-Eintrag und keinen Fehler.

Daraus ergeben sich zwei ziemlich verschiedene Fälle.

Fall 1: Das Geld ist längst da. Typisch für 5.3.0. Eine PayPal-, iDEAL- oder Kreditkartenzahlung mit automatischem Capture ist sofort paid, und einen Capture auf eine solche Zahlung nimmt Mollie nicht an; der Capture-Endpunkt ist laut Mollie-Doku für Zahlungen mit captureMode: manual gedacht. Der Fehler ist dann Rauschen. Dein Geld ist bereits auf dem Weg zu dir.

Fall 2: Das Geld ist nur reserviert. Ab 5.4.0 ist das der Normalfall dieser Meldung, weil der Reconciler die harmlosen Fälle vorher aussortiert. Hier gibt es eine offene Autorisierung, und der Versuch, sie einzuziehen, ist fehlgeschlagen. Die Ware ist raus, das Geld nicht drin.

Was mit der Autorisierung passiert

Eine Autorisierung läuft ab. Mollie nennt in der Doku zu „Place a hold for a payment“ diese Fristen:

Zahlart Autorisierung gültig
Visa, American Express 7 Tage
MobilePay 14 Tage
Klarna, Billie, Billink 28 Tage
Mastercard, Riverty 30 Tage
Vipps 180 Tage

Die Frist steht an jeder autorisierten Zahlung im Feld captureBefore und lässt sich nicht verlängern. Läuft sie ohne Capture ab, wechselt die Zahlung auf expired, und du kannst das Geld nicht mehr einziehen. Wurde vorher schon ein Teil eingezogen, geht sie auf paid, und der Rest ist weg.

Wenn die Meldung also bei einer Klarna-Bestellung auftaucht und niemand reagiert, hast du nach vier Wochen eine versendete Bestellung ohne Zahlung. Nichts in Shopware weist dich darauf hin.

Woran Captures scheitern

Welche Fehlermeldung Mollie genau zurückgegeben hat, steht nur im Feld exception. Die Doku zum Create-Capture-Endpunkt nennt 404 (Zahlung nicht gefunden), 422 (Anfrage fehlerhaft) und 429 (Rate Limit). Aus dem Plugin-Code und den Mollie-Regeln ergeben sich diese Kandidaten:

  • Teil-Capture bei Riverty oder Billink. Beide unterstützen laut Mollie nur einen vollständigen Capture. Versendest du nur einen Teil der Bestellung, will das Plugin genau diesen Teil einziehen.
  • Zweite Teillieferung bei Kreditkarte. Mehrfache Captures sind bei Karten standardmäßig aus und müssen bei Mollie beantragt werden. Bei Karten gibt Mollie den Restbetrag nach einem Teil-Capture zudem frei, sofern die Bank mitspielt.
  • Falscher API-Key oder falsches Profil im Verkaufskanal. Die Zahlung wird mit dem Schlüssel des Verkaufskanals abgefragt. Passt der nicht zu dem, mit dem die Zahlung angelegt wurde, findet Mollie sie nicht.
  • Rate Limit oder Verbindungsprobleme, etwa wenn ein ERP hunderte Bestellungen auf einmal auf „Versandt“ setzt.

In den Samples, die ich gesehen habe, war fullyShipped jeweils true und requestedItems leer, es wurde also die komplette Bestellung versendet. Die eigentliche Mollie-Antwort war dort abgeschnitten. Welche Ursache dahintersteckte, kann ich deshalb nicht sagen.

Was du jetzt prüfen musst

1. Die Mollie-Antwort lesen. Das Plugin schreibt in eine eigene, täglich rotierende Datei:

grep -h "createCapture failed" var/log/mollie_prod-*.log | tail -n 20

Notier dir molliePaymentId und den Inhalt von exception.

2. Die Zahlung im Mollie-Dashboard aufrufen. Such nach der tr_-ID. Entscheidend sind Status und Captures:

  • paid ohne offenen Betrag: Fall 1, nichts verloren.
  • authorized: Das Geld ist noch reserviert. Prüf captureBefore, dann weiter mit Schritt 4.
  • expired oder canceled: Die Reservierung ist weg. Das Geld musst du auf anderem Weg beim Kunden einfordern.

3. Die Plugin-Version prüfen.

bin/console plugin:list | grep -i mollie

Steht da 5.3.0 und die Meldung beginnt mit ShipOrderRoute:, ist ein Update der eigentliche Fix. Ab 5.4.0 werden Zahlarten ohne Reservierung gar nicht mehr captured, ab 5.7.0 ignoriert der automatische Versand Zahlarten, die nicht dafür gedacht sind, und der Button „Ship through Mollie“ im Mollie-Tab ist bei Zahlungen ohne manuellen Capture deaktiviert.

4. Offene Autorisierungen nachholen. Weil das Plugin bei einem Fehlschlag keine versendeten Mengen speichert, gilt die Bestellung für das Plugin weiterhin als offen. Du kannst den Versand über den Mollie-Tab der Bestellung erneut auslösen, sobald die Ursache behoben ist, oder den Capture direkt im Mollie-Dashboard anlegen. Ein erneuter Wechsel des Lieferstatus funktioniert nur, wenn die Lieferung vorher wieder aus „Versandt“ herausgenommen wird. Der Mollie-Tab ist der direktere Weg. Danach mit „Fetch Mollie data“ (ab 5.6.0) den Status aus Mollie zurückholen.

5. Bei Teillieferungen die Zahlart beachten. Wer Riverty oder Billink anbietet, sollte dort nur komplett versenden. Wer Kartenbestellungen mit Reservierung in mehreren Paketen verschickt, braucht bei Mollie freigeschaltete Multiple Captures.

Rauschen oder echtes Problem

Die Zeile hat Level ERROR, egal welcher Fall vorliegt. Unter 5.3.0 bekommst du sie bei jeder sofort bezahlten Bestellung, die auf „Versandt“ geht, und gewöhnst dich schnell daran, sie zu überlesen. Genau dann fällt die eine Klarna-Bestellung nicht auf, deren Reservierung in drei Wochen ausläuft. Update auf eine aktuelle 5.x-Version, und jede Meldung, die danach noch kommt, verdient einen Blick ins Dashboard.

Der Statuswechsel in der Administration läuft bei diesem Fehler ohne Warnung durch, auffallen kann er nur im Log. ShopSignal liest die Log-Fehler deines Shopware-6-Shops mit, fasst gleiche Meldungen zusammen und legt sie dir zusammen mit dem Health Score des Shops vor. Taucht createCapture failed dort auf, bleibt Zeit, den Capture nachzuholen, bevor die Frist bei Mollie abläuft.