News Shop-Management

Shopify Payments: GraphQL erkennt jetzt Währungsumrechnung als Transaktionstyp

Shopify hat den ShopifyPaymentsTransactionType in der GraphQL Admin API erweitert. Ab der Version 2026-10 enthält der Enum den neuen Wert CURRENCY_CONVERSION. Das klingt nach einem Detail für Entwickler. Für Shopbetreiber mit internationalem Verkauf ist es mehr als das: Währungsumrechnungen innerhalb von Shopify Payments werden damit erstmals als eigener Transaktionstyp ausgewiesen, statt in Sammelbuchungen oder Rundungsdifferenzen unterzugehen.

Wer über Shopify Payments in mehreren Währungen verkauft, kennt das Problem. Ein Kunde aus der Schweiz zahlt in CHF, abgerechnet wird in EUR, und in der Auszahlung taucht ein Betrag auf, der weder exakt dem Bestellwert noch dem Wechselkurs der Bestellung entspricht. Bislang ließ sich dieser Posten nur über Umwege rekonstruieren – über Settlement-Reports, manuelle Abgleiche oder den Umweg über die REST-API, die für Payments-Auswertungen ohnehin an Grenzen stößt. Mit dem neuen Enum-Wert wird die Umrechnung zu einem eigenständigen, abfragbaren Objekt.

Kernsatz: Der neue Transaktionstyp macht Währungsumrechnungen in Shopify Payments granular auswertbar – relevant für jede Buchhaltung, die Multi-Currency-Umsätze sauber trennen muss.

Was ändert sich konkret für Shopbetreiber?

Die Änderung betrifft zunächst alle, die eigene Integrationen, ERP-Anbindungen oder Reporting-Tools über die GraphQL Admin API betreiben. Wer eine bestehende Abfrage auf shopifyPaymentsAccount oder die zugehörigen Transaktionslisten laufen hat, sollte prüfen, ob der neue Enum-Wert in der eigenen Logik abgedeckt ist. Wird CURRENCY_CONVERSION nicht behandelt, kann eine Auswertung entweder fehlschlagen oder die Transaktion stillschweigend ignorieren – ein klassisches Integrationsrisiko bei Enum-Erweiterungen.

Für Standard-Shopify-Nutzer ohne eigene API-Anbindung ist die Änderung nicht sichtbar. Sie schlägt sich indirekt nieder, sobald Drittanbieter-Apps für Buchhaltung, Steuerexport oder Payment-Abstimmung auf die neue Version umstellen. Anbieter wie Buchhaltungs-Connectoren oder Reporting-Apps müssen die API-Version anheben, um den Wert zu erhalten. Händler sollten in den kommenden Wochen bei ihren Payment- und Buchhaltungs-Tools nachfragen, wann die Unterstützung für 2026-10 eingeplant ist.

Warum ist die Trennung von Umrechnung und Gebühr wichtig?

Wechselkursdifferenzen sind buchhalterisch eigenes Terrain. Sie sind keine Payment-Gebühr, kein Umsatz und kein Retourenposten. Wer sie in einen Sammelposten bucht, verliert die Möglichkeit, FX-Kosten über Zeit oder über Währungspaare hinweg zu analysieren. Genau das wird mit dem separaten Transaktionstyp möglich: Händler können Umrechnungskosten isoliert betrachten und gegen alternative Lösungspartner wie Airwallex, Stripe oder klassische FX-Broker stellen.

Für Shops mit relevantem Auslandsanteil ist das kein Nebenschauplatz. Bei einem Shop mit 30 Prozent Nicht-EUR-Umsatz und einem durchschnittlichen Spread von einem bis zwei Prozent entsteht schnell ein fünfstelliger Betrag pro Jahr allein aus Umrechnung. Bislang war dieser Posten schwer zu isolieren – jetzt lässt er sich in einem eigenen Datenfeld abfragen.

Der neue Transaktionstyp ist kein Marketing-Feature, sondern eine Datenmodell-Korrektur. Sie räumt eine Lücke, die jede Multi-Currency-Buchhaltung vorher manuell stopfen musste.

Wie sollten Händler jetzt vorgehen?

Drei Schritte sind sinnvoll. Erstens: die in Shop oder ERP genutzte GraphQL-API-Version prüfen und feststellen, ob 2026-10 bereits aktiv ist. Zweitens: bei externen Tools – Buchhaltung, Reporting, Reconciliation – nachfragen, wann der neue Wert unterstützt wird. Drittens: für den eigenen Reporting-Stack eine Abfrage bauen, die CURRENCY_CONVERSION-Transaktionen separat ausweist, statt sie in bestehende Kategorien zu mischen.

Shopify rollt API-Versionen quartalsweise aus, alte Versionen laufen nach zwölf Monaten aus. Wer jetzt nicht umstellt, muss es spätestens dann tun, wenn die vorherige Version abgekündigt wird. Der Aufwand ist gering – die Auswirkung auf die Transparenz der Payment-Kosten ist es nicht.