Deine Systeme auf Shop Cash vorbereiten

Bevor du Shop Cash-Workflows mit externen Systemen einführst, solltest du die folgenden Anforderungen überprüfen:

• Deine ERP-, OMS-, Fulfillment-, Buchhaltungs- und Rückgabesysteme können mehr als eine Zahlungsmethode für eine Bestellung akzeptieren.
• shop_cash wird als Zahlungsmethode zugeordnet, wo Gateway-Werte verfügbar sind.
• Shop Cash wird nicht als Rabatt, Gutschein oder Shop-Guthaben behandelt.
• Der Autorisierungswert wird als opaker String mit variabler Länge von mindestens 1024 Zeichen gespeichert. Verwende nach Möglichkeit ein unbegrenztes Textfeld.
• Erfassungen, Stornierungen und Rückerstattungen werden durch die Transaktions-ID anstelle des Autorisierungswerts identifiziert. Admin API-Vorgänge für Erfassung und Stornierung verwenden parentTransactionId und Rückerstattungsvorgänge verwenden parentId.
• Deine Systeme analysieren, decodieren, normalisieren, hashen oder kürzen keine Shop Cash-Autorisierungswerte.
• Deine Systeme können gruppierte Auszahlungen verarbeiten, bei denen eine shop_cash_credit-Zeile mehrere Bestellungen repräsentieren kann.
• Dein Abgleichs-Workflow setzt nicht voraus, dass eine Bestellung einer Auszahlungszeile entspricht.
• Dein Abgleichs-Workflow kann den Anteil von Shop Cash und den Anteil von Karten- oder Shop Pay-Ratenzahlungen verarbeiten, die über verschiedene Auszahlungen abgerechnet werden.
• Dein Rückerstattungs-Workflow kann teilweise Rückerstattungen über Karten- oder Shop Pay-Ratenzahlungen und Shop Cash hinweg verarbeiten.
• Rückerstattungs-Apps können die Shop Cash-Erfassungstransaktion rückerstatten, nicht die Autorisierungstransaktion.
• Wenn du Shop Campaigns vor Januar 2026 durchgeführt hast, verarbeitet dein Finanz-Workflow die historischen shop_cash_campaign_billing_debit- und zugehörigen Kampagnenabrechnungszeilen getrennt vom Bestellumsatz. Kampagnenkosten ab Januar 2026 werden stattdessen über deine Shopify-Rechnung abgerechnet.

Das Testen von Shop Cash weist Einschränkungen auf, da Shop Cash von Shop-Käuferkonten, Shop Cash-Guthaben, Shopify Payments und der Abrechnungsinfrastruktur von Shop Cash abhängig ist.

Die zuverlässigste Methode zur durchgehenden Validierung einer Integration für ein großes Unternehmen besteht darin, eine Produktionsbestellung mit geringem Wert über Shop aufzugeben und diese dann zurückzuerstatten. Dadurch werden produktionsähnliche Bestelltransaktionen, Erfassungsdaten, Auszahlungsaktivitäten, Rückerstattungstransaktionen und Rückerstattungsabbuchungsaktivitäten erstellt, die durch den Shopify-Adminbereich, die Admin API-Daten, Auszahlungsexporte und Auszahlungs-API-Daten fließen.

Development Shops können bei der Validierung einiger API-Feldstrukturen und Mapping-Logiken helfen, sie führen jedoch den vollständigen Checkout von Shop, das Käuferguthaben und den Abrechnungsfluss nicht zuverlässig aus. Der Testmodus und das Bogus-Gateway erstellen keine produktionsähnlichen Shop Cash-Auszahlungszeilen, da sie keinen Live-Abrechnungsfluss von Shopify Payments verwenden.

Du kannst die folgenden Workflows normalerweise mit einer über Shop initiierten Produktionsbestellung von geringem Wert testen:

• Bestellübernahme für eine Bestellung mit mehreren Zahlungsmethoden, die Shop Cash und Shop Pay oder Shop Pay-Ratenzahlung umfasst.
• ERP- oder OMS-Zuordnung für shop_cash.
• Speicherung des vollständigen Shop Cash-Autorisierungswerts.
• Vollständige und teilweise Rückerstattungen für die Bestellung.
• Übernahme der Auszahlungsaktivität shop_cash_refund_debit.
• Auszahlungsabgleich für Shop Cash-Gutschriften.
• Verhalten bei Vorabbestellung oder Erfassung beim Fulfillment, wenn dein Shop die verzögerte Erfassung nutzt.
• Verarbeitung in Rückgabe-Apps für Bestellungen mit mehr als einer Zahlungsmethode.

Wenn du Tests in der Produktionsumgebung durchführst, verwende eine Bestellung mit geringem Wert und befolge die internen Testbestellungs- und Rückerstattungsverfahren deines Shops.

Kontaktiere den Shopify Support, wenn du bei einem der folgenden Szenarien Hilfe benötigst:

• Überprüfung der Shop Cash-Verfügbarkeit für einen Markt, der sich in der Einführung befindet.
• Untersuchung einer fehlgeschlagenen Shop Cash-Erfassung oder -Rückerstattung.
• Untersuchung einer fehlenden Shop Cash-Auszahlungstransaktion nach deinem normalen Auszahlungsrhythmus plus einem zusätzlichen Auszahlungszyklus.
• Überprüfung, ob eine stornierte oder abgelaufene Shop Cash-Autorisierung erneut autorisiert werden kann.
• Planung einer Einführung für einen komplexen ERP-, OMS-, Vorabbestellungs- oder Fulfillment-Workflow.

Führe die folgenden Überprüfungen durch, bevor du das Shop Cash-Bestellvolumen skalierst:

• Das ERP- und OMS-Zahlungsmethoden-Mapping ist implementiert und für shop_cash verifiziert.
• Eine Shop Cash-Beispielbestellung wird durchgehend übernommen, einschließlich Autorisierungs- und Erfassungstransaktionen.
• Eine exemplarische Shop Cash-Auszahlungsgutschrift wird mit der ursprünglichen Bestellung bzw. den ursprünglichen Bestellungen abgeglichen.
• Eine exemplarische Shop Cash-Rückerstattung wird verarbeitet und mit der Rückerstattungsabbuchung abgeglichen.
• Gruppierte Shop Cash-Auszahlungszeilen werden unterstützt oder verfügen über einen manuellen Abgleichsprozess.
• Die Zuordnung teilweiser Rückerstattungen wird von deinen Support- und Finanzteams verstanden.
• Das Verhalten bei Vorabbestellung, manueller Erfassung und Erfassung beim Fulfillment wird ggf. validiert.
• Rückgabe-Apps können die richtige Shop Cash-Erfassungstransaktion identifizieren und rückerstatten.
• Support- und Finanzteams kennen den Unterschied zwischen dem Shop Cash-Guthaben von Kund:innen, Shop-Angeboten und Abrechnungsaktivitäten für Shop Campaigns.

Informationen zu Anforderungen bezüglich API- und Bestelldaten findest du unter Shop Cash-Bestelldaten und externe Integrationen. Anforderungen bezüglich Auszahlungen findest du unter Shop Cash-Auszahlungen abgleichen.