Shopify hat den Transaktionstyp seiner Payments-API um einen Wert erweitert, der für international aufgestellte Händler relevant wird: Ab der GraphQL Admin API Version 2026-10 enthält der Typ ShopifyPaymentsTransactionType den neuen Wert CURRENCY_CONVERSION. Damit lassen sich Gebühren und Beträge, die durch Währungsumrechnung im Zahlungsfluss entstehen, künftig sauber als eigener Transaktionstyp ausweisen statt sie unter Sammeltypen wie ADJUSTMENT oder CHARGE zu verbuchen.
Was ändert sich konkret in der Payments-API?
Bislang tauchten Umrechnungsvorgänge im Shopify Payments-Balance-Bereich nur indirekt auf. Wer über Shopify Markets in mehreren Währungen verkauft, sah zwar die Auszahlung in der Auszahlungswährung, aber die einzelnen Umrechnungsschritte ließen sich per API nicht eindeutig filtern. Mit dem neuen Enum-Wert lässt sich eine GraphQL-Abfrage auf shopifyPaymentsAccount.balanceTransactions künftig gezielt nach transactionType: CURRENCY_CONVERSION einschränken. Das ist vor allem für Händler interessant, die ihre Buchhaltung oder ihr ERP nicht mehr per CSV-Export, sondern über die Admin API anbinden.
Die Änderung ist additiv. Bestehende Queries funktionieren weiter, der neue Wert erscheint nur dann in den Ergebnissen, wenn Shopify tatsächlich eine Währungsumrechnung verbucht. Wer den Typ in einem eigenen Enum-Mapping pflegt — etwa in einer Middleware oder einem Datenmodell im ERP — muss ihn dort ergänzen, sonst bricht die Verarbeitung mit einem unbekannten Wert ab. Das ist der klassische Fehler bei GraphQL-Enums: unbekannte Werte werden nicht ignoriert, sondern führen je nach Client zu Parse-Fehlern.
Warum ist das für Multi-Currency-Händler relevant?
Währungsumrechnung ist einer der am schlechtesten sichtbaren Kostenblöcke im grenzüberschreitenden Handel. Wer in Euro kalkuliert, aber in CHF, GBP oder SEK verkauft, kennt die Marge oft nur auf Basis der Auszahlungssumme — nicht pro Transaktion. Genau hier setzt der neue Wert an: Statt Umrechnungsbeträge aus Differenzen zwischen Bestellwert und Auszahlung zu rekonstruieren, können Controlling und Buchhaltung den Typ direkt abfragen.
Praktisch betrifft das Händler, die Shopify Payments mit Shopify Markets kombinieren. Wer stattdessen einen externen Payment-Provider wie Adyen, Mollie oder Stripe nutzt, bleibt außen vor — die Änderung liegt ausschließlich in der Shopify-Payments-Domäne. Für den Buchhaltungs-Workflow ist außerdem relevant, dass Umrechnungsgewinne und -verluste steuerlich getrennt behandelt werden; ein eigener Transaktionstyp erleichtert die Zuordnung zu den entsprechenden Konten.
Wie sollten Händler jetzt vorgehen?
Zunächst prüfen, ob die eigene Shopify-App oder Middleware die Admin API in Version 2026-10 oder höher anspricht. Shopify versioniert Quartal für Quartal; ältere Versionen werden nach zwölf Monaten abgeschaltet. Wer den GraphQL-Endpunkt fest auf eine ältere Version gepinnt hat, sieht den neuen Typ erst nach dem Versionssprung.
Danach den eigenen Code auf Enum-Handling durchsuchen. Bibliotheken wie graphql-request oder Apollo liefern unbekannte Enum-Werte je nach Konfiguration als String durch oder werfen einen Fehler. Ein gezielter Testabruf mit einer bekannten Umrechnungstransaktion klärt das schnell.
Für Händler ohne eigene Entwickler-Ressourcen lohnt ein Blick auf Buchhaltungs-Apps, die die Shopify-Payments-API auslesen. Anbieter wie Bookkeep oder A2X verarbeiten Balance-Transaktionen automatisiert, müssen den neuen Typ aber erst in ihr Mapping aufnehmen. Wer betroffen ist, sollte beim Support nachfragen, ob CURRENCY_CONVERSION bereits verarbeitet wird — sonst landen die Beträge in der Buchhaltung zunächst in einer unbestimmten Kategorie.
Die Änderung selbst ist klein. Ihre Wirkung entfaltet sie erst in dem Moment, in dem eine Integration mit einem unbekannten Enum-Wert konfrontiert wird — und das passiert selten im Test, häufiger mitten im Monatsabschluss.