Wer B2B-Bestellungen über die Payments Apps API abwickelt, sollte seine Validierungslogik prüfen. Der B2B-Checkout behandelt den Nachnamen des Käufers neuerdings als optionales Feld. Payment-Session-Requests für B2B-Aufträge dürfen family_name in shipping_address und billing_address damit weglassen. Bislang verlangten viele Zahlungs-Apps genau dieses Feld — und blockierten damit gültige Bestellungen, die im Shop selbst längst durchgelaufen waren.
Der Fall ist unspektakulär und genau deshalb relevant. Im B2B-Handel ist die Einzelperson oft nicht der Rechnungsempfänger. Einkäufer ordern im Namen einer Firma, der Nachname verliert an Bedeutung, während Firmenname, USt-IdNr. und Kostenstelle die eigentlichen Identifikatoren sind. Shopsysteme haben darauf reagiert, die API-Spezifikation zieht jetzt nach.
Warum verlieren Händler B2B-Umsätze an einer Pflichtfeld-Prüfung?
Die Antwort ist so simpel wie unangenehm: Der Checkout schließt ab, die Zahlung nicht. Tritt das Feld family_name leer auf, wirft eine App, die es als Pflichtwert erwartet, einen Validierungsfehler zurück. Der Käufer sieht eine abgebrochene Session, das ERP erhält keine Zahlungsbestätigung, der Warenkorb bleibt offen. Bei Bestellvolumina ab einer Million Euro Jahresumsatz summiert sich das schnell auf fünfstellige Beträge pro Quartal — je nach B2B-Anteil.
Betroffen sind vor allem Entwickler und Agenturen, die eigene Payment-Apps oder Middleware zwischen Shop und PSP betreiben. Reine Standard-Integrationen von Shopify, Shopware oder Adobe Commerce sind in der Regel nicht betroffen, da deren Adressvalidierung auf Shop-Ebene greift. Sobald aber eine eigene Payments-App ins Spiel kommt — etwa für Rechnungskauf, SEPA-Lastschrift oder individuelle PSP-Anbindungen —, liegt die Feldprüfung in der eigenen Verantwortung.
Wie sieht die konkrete Umstellung aus?
Technisch ist die Änderung überschaubar. In der Validierungsschicht der Payment-App muss family_name aus der Liste der Pflichtfelder entfernt werden, idealerweise sowohl für shipping_address als auch für billing_address. Das gilt nur für den B2B-Kontext. Im B2C-Checkout bleibt der Nachname Pflicht, dort ist er für Betrugsprävention, Adressverifikation und Versanddienstleister-Anbindung nach wie vor notwendig.
Wer sauber arbeiten will, unterscheidet die beiden Pfade explizit. Ein Flag wie is_b2b am Request oder ein separater Validierungspfad verhindert, dass die Lockerung versehentlich in den B2C-Bereich durchschlägt. Der Aufwand liegt bei wenigen Stunden Entwicklungszeit. Die Alternative — Bestellungen manuell nachzuerfassen — kostet ungleich mehr.
- Prüfen, ob die eigene Payment-App oder Middleware family_name erzwingt.
- Validierungsregeln getrennt nach B2B und B2C führen.
- Feld im B2B-Pfad als optional markieren, Fallback auf Firmenname.
- Testbestellungen ohne Nachnamen gegen die Live-Session fahren.
Wer seine Zahlungsabwicklung über eine fertige App-Lösung wie Shopify Payments, Mollie oder Stripe betreibt und keine eigene Validierung vorgeschaltet hat, ist nicht betroffen. Kritisch wird es erst bei Eigenentwicklungen und bei Agenturen, die Payment-Flows für mehrere Mandanten betreiben. Dort lohnt ein Blick in die Codebasis, bevor die nächste B2B-Rechnungswelle aufläuft.
Für die Mehrheit der Händler ist die Meldung damit ein Randnotiz-Kandidat. Für alle mit einer eigenen Payments-App ist sie ein direktes Umsatzthema — und ein Hinweis darauf, wie eng Checkout-Logik und Payment-Logik inzwischen verzahnt sind. Wer hier nicht nachzieht, verliert Bestellungen, die der Shop bereits als erfolgreich verbucht hat.