Wer über Shopify Payments in fremden Währungen abwickelt, kennt das Problem bei der Abstimmung: Die Umrechnung tauchte in den Rohdaten als Teil der Zahlungstransaktion auf. Mit der GraphQL Admin API Version 2026-10 führt Shopify den neuen Transaktionstyp CURRENCY_CONVERSION in der Enum ShopifyPaymentsTransactionType ein. Die Umrechnung wird damit erstmals als eigenständiger Balance-Transaction-Typ ausgewiesen.
Für Shopbetreiber ist das mehr als ein API-Detail. Der Balance-Transaction-Graph bildet jede Bewegung ab, die den Shopify-Payments-Saldo verändert – Gebühren, Auszahlungen, Rückbuchungen, Währungseffekte. Bisher ließen sich FX-Kosten nur indirekt aus verknüpften Feldern rekonstruieren. Der neue Type trennt den Umrechnungsvorgang sauber von der eigentlichen Zahlung und macht ihn einzeln abfragbar.
Was ändert sich konkret in der GraphQL Admin API 2026-10?
Der Typ CURRENCY_CONVERSION ergänzt die bestehende Aufzählung in ShopifyPaymentsTransactionType. Abfragen, die auf dieser Enum aufsetzen, können den neuen Wert ab sofort zurückgeben. Wer bisher per Pattern-Matching oder über den Umweg der Fee-Transaktionen auf Umrechnungen geschlossen hat, sollte die eigene Logik prüfen: Ein bisheriger Sammeltyp kann nun in mehrere Einträge zerfallen.
Relevant ist das vor allem für Shops mit aktivem Shopify Markets, mehreren Verkaufswährungen oder lokalisierten Preisen. Sobald Bestellungen in einer anderen Währung als der Auszahlungswährung beglichen werden, entsteht bei Shopify Payments eine Umrechnung. Diese wird nun separiert ausgewiesen – statt implizit in der Zahlungszeile zu verschwinden.
Warum verlieren Händler bei Fremdwährungen den Überblick?
Die eigentliche Tücke liegt nicht in der Gebühr, sondern in der Zuordnung. Sobald Umrechnung, Zahlung und Gebühr in derselben Transaktionszeile liegen, kollidiert die automatisierte Buchhaltung. ERP-Systeme und Buchhaltungstools müssen dann heuristisch raten, welcher Anteil auf den tatsächlichen Verkauf und welcher auf den Währungseffekt entfällt. Mit CURRENCY_CONVERSION bekommt jede Bewegung eine eindeutige ID und einen eindeutigen Typ.
In der Praxis ist der Effekt dann am größten, wenn mehrere Währungen und Rückbuchungen zusammenkommen. Ein Shop, der in EUR auszahlt, aber in CHF, GBP und USD verkauft, sammelt pro Abrechnungsperiode Hunderte solcher Transaktionen. Wer die jetzt gefiltert abfragen kann, verkürzt den Monatsabschluss erheblich. Wer stattdessen weiter auf Saldenvergleiche setzt, wird die Differenz zwischen Shopify-Payments-Report und Buchhaltung nie vollständig auflösen.
Der Balance-Transaction-Graph ist die einzige verlässliche Quelle für das tatsächliche Payment-Ergebnis – nicht das Umsatz-Dashboard.
Für Händler, die ihre Payments-Daten automatisiert auswerten, lohnt sich ein Blick auf die eingesetzte Toolchain. Reporting-Apps wie Vault oder Buchhaltungs-Konnektoren von Anbietern wie Accuris lesen die GraphQL Admin API direkt aus. Solche Extensions müssen die Enum-Erweiterung zeitnah übernehmen, sonst klassifizieren sie den neuen Typ als „unknown“ und verlieren den Umbuchungsbetrag im Report. Vor einem Update der eigenen Query sollte man im Partner-Dashboard oder direkt über den API-Version-Header auf 2026-10 wechseln und den Response prüfen.
Die API-Versionierung selbst gibt den Takt vor: Shopify hat frühere Versionen abgekündigt, wer noch auf 2025-01 oder älter abfragt, verliert perspektivisch den Zugriff. Wer die Ablösung plant, kann den neuen Typ gleich mit einbauen und die alte Heuristik entfernen.
Ob aus dem Reporting-Update eine echte Erleichterung wird, hängt weniger an Shopify als an der eigenen Buchhaltungslogik. Händler mit hohem Fremdwährungsanteil sollten die Migration gezielt in einem Testshop durchspielen, bevor sie die Produktionsqueries umstellen. Ein reiner Enum-Wert ändert keine Umsätze – aber er kann den Unterschied machen zwischen einer Zahl, die man erklären kann, und einer, die man wegdiskutiert.