News B2B

Shopify Payments API: familyname wird für B2B-Bestellungen optional

Shopify Payments API: familyname wird für B2B-Bestellungen optional

Wer im B2B-Geschäft Rechnungen stellt, weiß: Firmen kaufen auf Namen, nicht auf Nachnamen. Genau diese Logik hat Shopify jetzt bis in die Payments Apps API durchgezogen. Bei B2B-Bestellungen ist der Nachname des Käufers nun optional, Requests an die Payment-Session-API können family_name in shipping_address und billing_address künftig weglassen. Für Shopbetreiber mit eigenem Checkout-Frontend und angebundenen Payment-Apps ist das mehr als eine Randnotiz.

Was genau ändert sich im Checkout?

B2B-Checkouts behandeln den Nachnamen des Bestellers schon länger als optionales Feld. Die Payments Apps API zieht jetzt nach: Sie akzeptiert Adressobjekte ohne family_name, solange die Bestellung als B2B klassifiziert ist. Die Änderung betrifft ausschließlich diesen Kanal, im B2C-Checkout bleibt der Nachname ein Pflichtfeld.

Kritisch wird es für Payments Apps, die bislang selbst eine Validierung auf family_name durchführen. Solche Integrationen brechen nicht sofort, verlieren aber Anfragen mit leerem Nachnamenfeld oder werfen Validierungsfehler zurück. Shops, die eine eigene Payment-App oder ein Middleware-Layer zwischen Shopify und PSP betreiben, sollten die Request-Validierung prüfen.

Kernsatz: Die API akzeptiert nun, was der B2B-Checkout ohnehin erlaubt, Apps, die strenger validieren, müssen ihre Logik lockern, sonst drohen Checkout-Abbrüche bei Firmenkunden.

Warum verlieren Händler B2B-Umsätze durch zu strenge Adressvalidierung?

Der Fall zeigt ein Muster, das im B2B-Segment teuer wird: Firmenkunden kaufen über Einkaufsplattformen, Sammelrechnungen oder Punchout-Anbindungen wie SAP Ariba und Coupa. Dort werden Bestelldaten aus ERP-Systemen übergeben, und viele Systeme führen nur einen Ansprechpartner mit Firmenname, nicht zwingend einen individuellen Nachnamen. Schlägt die Payment-Integration bei so einem Request fehl, sieht der Einkäufer keinen Fehlercode, sondern einen abgebrochenen Bezahlvorgang.

Für Shopbetreiber heißt das: Wer B2B über die Payments Apps API abwickelt, sollte die eigene App beziehungsweise den Integrationspartner zeitnah informieren. Die Prüfung ist überschaubar, zwei Felder, ein Conditional, aber die Kosten eines übersehenen Validierungsfehlers liegen im fünf- bis sechsstelligen Bereich, sobald Großkunden betroffen sind.

Was bedeutet das für Shopify Plus und Headless-Setups?

B2B-Commerce funktioniert nach anderen Regeln als der klassische D2C-Checkout, die API muss diese Regeln abbilden, nicht umgekehrt.

Besonders relevant ist die Änderung für Shopify-Plus-Händler mit Headless-Frontend oder eigenen Checkout-Flows. Wer die Payments Apps API direkt anspricht, etwa über Hydrogen oder eine Custom-Storefront, muss die Adressobjekte nicht mehr künstlich mit Platzhalternachnamen befüllen. Das war bislang gängige Praxis, um Validierungsfehler zu umgehen, und führte zu Datenmüll in Bestell- und Rechnungsdaten. Rechnungsstellungssysteme und Buchhaltungsanbindungen, die auf einen vollständigen Namen im Adressdatensatz setzen, sollten ebenfalls geprüft werden.

Wer eine passende Lösung sucht: Payment-Apps wie Shopify Payments, Stripe oder Adyen übergeben Adressdaten je nach Konfiguration unterschiedlich streng. Ein Blick in die App-Dokumentation zur B2B-Kompatibilität lohnt sich, bevor der nächste Firmenkunde im Checkout hängen bleibt.

Ein letzter Hinweis für Teams mit eigenem Monitoring: Bestellungen ohne family_name tauchen in Analytics und CRM-Exports als unvollständige Datensätze auf. Wer hier Filter oder Dedupe-Logik laufen hat, sollte sie vor dem Rollout anpassen, sonst zählt das Reporting künftig anders als der tatsächliche Umsatz.