News Tools

Shopify Functions: createdAt-Feld bringt Kundenalter in Rabatt- und Checkout-Logik

Wann wurde ein Kundenkonto angelegt? Diese simple Frage ließ sich in Shopify Functions bislang nicht beantworten – die API lieferte das Erstellungsdatum schlicht nicht aus. Mit der API-Version 2026-10 ändert sich das: Das Customer-Objekt exponiert jetzt das Feld createdAt, das Datum und Uhrzeit der Kontoerstellung zurückgibt. Für Händler, die Rabatte, Versandregeln oder Checkout-Anpassungen über Functions steuern, eröffnet das neue Segmentierungsmöglichkeiten direkt in der Ausführungslogik.

Was genau hat Shopify am Customer-Objekt geändert?

Die Antwort ist kurz: Es ist ein rein additiver Change. Das Customer-Objekt in der Functions-API liefert ab Version 2026-10 zusätzlich createdAt mit – ein Zeitstempel, der das Anlagedatum des Kundenkontos abbildet. Bestehende Functions laufen ohne Anpassung weiter, eine Migration ist nicht nötig. Wer das neue Feld nutzen will, aktualisiert seine Function auf die API-Version 2026-10 und greift im Input-Query auf das Feld zu.

Technisch ordnet sich das in Shopifys stetigen Ausbau der Functions-Schnittstellen ein. Seit die Plattform Script Editor und Checkout-Liquid schrittweise ablöst, hängt jede Individualisierung von Rabatten, Payment- oder Delivery-Optionen daran, welche Daten die Functions-API überhaupt bereitstellt. Jedes neue Feld im Input-Schema erweitert den Spielraum – ohne dass Händler auf externe Middleware ausweichen müssen.

Kernsatz: Mit createdAt lässt sich das Kundenalter erstmals direkt in Shopify Functions auswerten – etwa für Willkommensrabatte mit Verfallsdatum oder Neukunden-Schwellen im Checkout.

Warum das Kundenalter im Checkout praktisch relevant ist

Die naheliegendste Anwendung: zeitlich begrenzte Neukunden-Logik. Bisher ließ sich zwar prüfen, ob ein Kunde bereits Bestellungen hat – nicht aber, ob sein Konto erst drei Tage alt ist. Ein „10 Prozent in den ersten 14 Tagen nach Registrierung“-Rabatt musste deshalb über Apps oder externe Systeme abgebildet werden. Mit createdAt wandert diese Logik in eine Discount Function: Das Feld wird gegen die aktuelle Zeit geprüft, der Rabatt greift nur innerhalb des definierten Fensters.

Ähnlich funktionieren Versandregeln. Ein Händler kann Neukunden in den ersten Wochen kostenlosen Versand anbieten, um die zweite Bestellung zu fördern, oder umgekehrt Risiko-Logik bauen: Kunden, deren Konto erst wenige Stunden alt ist, erhalten bestimmte Zahlungsarten nicht – ein Hebel gegen Betrugsmuster, bei denen Täter frische Konten mit geklauten Zahlungsdaten kombinieren. Payment Customization Functions können dafür die Kontoalter-Prüfung direkt einbeziehen.

Auch B2B-Szenarien profitieren. Händler, die Geschäftskunden nach Onboarding-Phase staffeln – etwa Freigabe bestimmter Zahlungsziele erst nach einer Bewährungsphase – bekommen mit dem Kontoalter ein objektives Kriterium, das bislang nur über Metafields und manuelle Pflege abzubilden war.

Was Händler jetzt tun sollten

Wer bereits Shopify Functions einsetzt – sei es über eigene Apps oder Lösungen aus dem App Store –, sollte prüfen, welche Regeln bislang über den Umweg Metafields oder externe Daten gelöst sind. Typische Kandidaten: Willkommensrabatte, Anti-Fraud-Regeln im Checkout, gestaffelte Versandkonditionen. Diese lassen sich mit createdAt schlanker und wartbarer bauen, weil der Zeitstempel aus der Plattform selbst kommt statt aus synchronisierten Zusatzdaten.

Zwei Punkte verdienen Aufmerksamkeit. Erstens: createdAt bezieht sich auf das Kundenkonto, nicht auf die erste Bestellung. Gäste, die lange ohne Konto kaufen und sich später registrieren, erscheinen als „neu“ – wer Kundentreue belohnen will, braucht weiterhin Bestelldaten. Zweitens gilt das Feld nur für Functions auf API-Version 2026-10; ältere Versionen liefern es nicht aus, ein gezieltes Update der Function ist also Pflicht.

Für Shops ohne eigene Entwicklungskapazität dürfte das Feld bald in Apps ankommen: Rabatt- und Checkout-Extensions, die bislang Neukundenlogik über Bestellhistorie annäherten, können sie nun exakt abbilden. Es lohnt sich, die Changelogs der eingesetzten Apps im Auge zu behalten.

Der Change ist klein, aber symptomatisch: Shopify baut die Functions-API Feld für Feld aus, bis die klassischen Script-Editor-Anwendungsfälle vollständig abgedeckt sind. Wer seine Checkout-Logik noch nicht migriert hat, sollte die 2026-10-Version zum Anlass nehmen – die nächsten Felder kommen bestimmt.