No Cart - Kommunikation ohne Warenkorb

  • Aktualisiert

No Cart

No Cart ermöglicht es, Transaktionen über collana pay durchzuführen, ohne dass Warenkorb-Daten an den Payment Service Provider übermittelt werden. Die API-Schnittstellen bleiben dabei unverändert, die Funktion wird ausschließlich über eine Konfiguration am Provider Account gesteuert.

Diese Funktion ist besonders dann relevant, wenn sich die Verkaufszeilen in Microsoft Dynamics 365 Business Central nachträglich ändern, der ursprüngliche Warenkorb aber nicht mehr aktualisiert werden kann.

No Cart sollte nur bewusst eingesetzt werden, da dadurch die Transparenz und Nachvollziehbarkeit von Transaktionen eingeschränkt wird. Wenn möglich, sollte stattdessen die Funktion Cart Update verwendet werden.

Funktionsweise

Nach der Aktivierung kann die API sowohl mit als auch ohne Warenkorb-Parameter aufgerufen werden. Der Warenkorb wird in beiden Fällen nicht an den PSP weiterkommuniziert. Die Konfiguration ist dabei pro Endpunkt steuerbar, sodass z. B. ein Create-Request ohne Warenkorb und ein Capture-Request mit Warenkorb kombiniert werden können.

Unterstützte Payment Service Provider

No Cart ist aktuell für folgende PSPs umgesetzt:

  • PayPal
  • Amazon Pay
  • Computop
  • Mollie
  • PayOne

Typische Anwendungsfälle

  • Bundles im Shop, die erst in Business Central in einzelne Set-Artikel aufgelöst werden
  • Nachträglicher Austausch von Artikeln (z. B. andere Varianten oder Ersatzartikel)
  • Payment Service Provider, bei denen ein Cart Update technisch nicht unterstützt wird
  • Transaktionen in einem Status, in dem ein Cart Update nicht mehr möglich ist

Wichtige Einschränkungen

  • Kommunikation ohne Warenkorb ist nicht bei allen Payment Service Providern möglich
    (z.B. vor allem bei Rechnungsstellenden PSP wie Klarna, Riverty, Ratepay, etc.)
  • Bei bestehenden gebuchten Rechnungen funktioniert No Cart nicht mehr
  • In den collana pay Logs sind im Zweifelsfall keine Warenkörbe mehr sichtbar
  • Historische Warenkorbinformationen sind nur noch im ursprünglichen Request einsehbar

Aktivierung von No Cart

Schritt 1: Aktivierung in copal

No Cart wird am Provider Account über das Feld DisableCartValidation aktiviert. Das Feld erlaubt eine gezielte Auswahl der Endpunkte, für die die Warenkorb-Validierung deaktiviert werden soll:

Wert Betroffener Endpunkt
Transactions Zahlungsinitiierung (Create)
Captures Captures
Refunds Refunds
Imports Transaktionsimporte

Es können mehrere Werte gleichzeitig ausgewählt werden. Endpunkte ohne Eintrag verhalten sich weiterhin wie gewohnt.

Schritt 2: Aktivierung in Business Central

In Business Central gibt es zwei Möglichkeiten:

  • Global für eine Zahlungsform:
    collana pay EinrichtungZahlungsformen Karte der Zahlungsform → No Cart aktivieren


     
  • Für eine einzelne Transaktion:
    collana pay TransaktionNo Cart aktivieren

Verhalten beim Ändern von Verkaufszeilen

Wenn No Cart aktiv ist, die Verkaufszeilen geändert werden und der Auftrag freigegeben wird:

  1. Ein Pop-up erscheint mit der Frage, ob die Zeilen aktualisiert werden sollen

  2. Nach Bestätigung werden die Verkaufszeilen in die Transaktionskarte übernommen
  3. Der Auftrag wird freigegeben

Die Transaktion enthält danach ausschließlich die aktuellen Verkaufszeilen.

  • Einzelne Zeilen dürfen andere Preise haben
  • Der Total Amount aller Zeilen muss exakt dem ursprünglichen Betrag der Transaktion entsprechen
  • Der Gesamtbetrag darf sich nicht ändern

Soll der Auftrag noch nicht freigegeben werden kann über die Transaktionskarte der Button Recreate All Transaction Items verwendet werden um die Verkaufszeilen an die Transaktion zu schreiben.

 

Verknüpfung mit