Wer über Shopify Payments in mehreren Währungen verkauft, kennt das Problem: In der Transaktionsübersicht tauchen Umrechnungsgebühren und Währungseffekte bisher nicht als eigener Posten auf. Mit der GraphQL Admin API in der Version 2026-10 ändert Shopify das. Der Enum ShopifyPaymentsTransactionType enthält jetzt den Wert CURRENCY_CONVERSION. Damit lassen sich Umrechnungsvorgänge innerhalb der Shopify-Payments-Balance erstmals sauber von Zahlungen, Erstattungen und Auszahlungen trennen.
Konkret bedeutet das: Jede Transaktion, bei der Shopify eine Fremdwährung in die Auszahlungswährung des Händlers umrechnet, erscheint künftig mit einem eigenen Typ. Bislang ließen sich diese Beträge nur indirekt über Gebühren- oder Saldo-Positionen rekonstruieren. Für Händler mit Verkäufen in USD, GBP oder CHF ist das ein relevanter Unterschied, sobald die Buchhaltung Währungseffekte getrennt ausweisen muss.
Was ändert sich konkret für die Shopify-Payments-Auswertung?
Der neue Typ sitzt im Balance-Transaction-Modell der GraphQL Admin API. Wer Abfragen auf shopifyPaymentsAccount oder die zugehörigen Transaktionslisten gebaut hat, filtert bisher über Werte wie CHARGE, REFUND, ADJUSTMENT oder PAYOUT. Ab der API-Version 2026-10 kommt CURRENCY_CONVERSION als zusätzlicher Filterwert hinzu. Ohne Anpassung laufen bestehende Auswertungen weiter – aber die Umrechnungsposten bleiben unsichtbar. Ein Blick in die eigene Query ist deshalb Pflicht, bevor die Version nach der Support-Frist abgeschaltet wird.
Praxisrelevant ist das vor allem für Händler, die Shopify Payments mit mehreren Verkaufswährungen kombinieren. Die Umrechnungsmarge verschwindet nicht mehr im Sammelposten, sondern lässt sich pro Transaktion nachvollziehen. Für das Reporting heißt das: Der tatsächliche Deckungsbeitrag pro Bestellung wird genauer, weil Währungseffekte getrennt ausgewiesen werden können.
Wer seine Daten in ein ERP oder eine Buchhaltungs-App spiegelt, sollte die Mapping-Logik prüfen. Ein bislang unbekannter Transaktionstyp kann Importe verwerfen oder in einen Fallback-Topf schieben. Bei Lösungen wie dem Shopify-Connector von Lexoffice, sevdesk oder Billbee lohnt der Blick in die Release Notes: Anbieter, die Balance Transactions granular verarbeiten, ziehen den neuen Typ meist in einem Minor-Update nach. Wer eine Eigenentwicklung betreibt, muss den Enum-Wert selbst ergänzen.
Warum ist die Trennung für die Buchhaltung mehr als ein Detail?
Währungsumrechnungen sind steuerlich und bilanziell keine Gebühren im engeren Sinn. Sie beeinflussen den realisierten Umsatz und damit die Erlösrechnung. Solange sie sich nicht isoliert ausweisen ließen, war der tatsächliche Durchschnittskurs pro Abrechnungsperiode nur über Umwege zu bestimmen. Mit dem neuen Transaktionstyp lässt sich der effektive Umrechnungskurs direkt aus den Rohdaten berechnen – relevant für Händler, die Fremdwährungsbestände oder Kursdifferenzen separat dokumentieren müssen.
Ein zweiter Effekt: Auffälligkeiten werden sichtbar. Springt die Umrechnungsdifferenz in einer Woche ungewöhnlich hoch, liegt das entweder an Kursbewegungen oder an einer veränderten Marge im Payout. Beides lässt sich nun zuordnen, statt es dem Gesamtsaldo zuzuschreiben.
Wann müssen Händler die API-Abfrage anpassen?
Die Version 2026-10 wird regulär eingeführt, ältere Versionen laufen nach der üblichen Shopify-Update-Policy aus. Händler mit eigenen GraphQL-Integrationen sollten den Enum-Wert jetzt in ihre Filter- und Mapping-Logik aufnehmen – unabhängig davon, ob sie die Auswertung selbst nutzen. Wer ausschließlich das Shopify-Admin-Backend verwendet, merkt zunächst wenig. Sobald aber ein Tool oder Skript Balance Transactions ausliest, ist die Anpassung fällig. Ein Testlauf gegen die neue API-Version zeigt in wenigen Minuten, ob Importe den zusätzlichen Typ korrekt verarbeiten.