News B2B

Payments Apps API: familyname wird für B2B-Aufträge optional

Wer B2B über Shopify abwickelt, kennt das Problem: Ein Einkäufer gibt beim Checkout nur den Firmennamen und die USt-IdNr. an, der Nachname fehlt — und die Payment-App lehnt die Anfrage ab. Genau diese Hürde fällt jetzt weg. Die Payments Apps API behandelt family_name in shipping_address und billing_address bei B2B-Aufträgen nicht mehr als Pflichtfeld.

Die Änderung ist technisch unspektakulär, operativ aber relevant. B2B-Checkouts verlangen traditionell keinen vollständigen Personennamen, weil der Rechnungsempfänger die Firma ist. Bisher mussten Payment-Apps, die über die Payments Apps API angebunden sind, den Nachnamen dennoch validieren — sonst schlug die Session-Erstellung fehl. Mit dem Update entfällt diese künstliche Anforderung.

Was ändert sich konkret für Shopbetreiber?

Betroffen sind ausschließlich Payments Apps, die B2B-Aufträge über die Payments Apps API verarbeiten und family_name bislang im Request-Schema erzwingen. Wer eine Standard-Checkout-Lösung ohne eigene API-Anbindung nutzt, merkt nichts. Wer jedoch eigene Validierungslogik in der Payment-Session aufgebaut hat, sollte prüfen, ob dort noch eine Pflichtfeldprüfung auf den Nachnamen läuft.

Der Handlungsimpuls ist eindeutig: Entwicklerteams sollten die eigene Request-Validierung gegen die aktualisierte API-Spezifikation abgleichen. Ein hartcodiertes required: family_name führt sonst weiterhin zu abgewiesenen Sessions, obwohl die API sie inzwischen akzeptieren würde. Besonders relevant ist das für Händler mit hohem B2B-Anteil, bei denen Einkäufer häufig ohne Klarnamen bestellen — etwa über Sammelbestellungen oder Beschaffungsplattformen.

Kernsatz: Die API lockert die Anforderung — die Fehlerquelle liegt jetzt in der eigenen App-Logik, nicht mehr im Shopify-Kern.

Warum die Änderung mehr ist als ein Detail

B2B-Commerce unterscheidet sich in den Adressanforderungen systematisch von B2C. Rechnungsadresse ist die Firma, Ansprechpartner sind optional, die USt-IdNr. ist das eigentliche Identifikationsmerkmal. Payment-Anbieter, die ihre Validierung an B2C-Mustern ausrichten, produzieren hier Reibung im Kaufabschluss. Die Anpassung der Payments Apps API ist deshalb ein Signal: Shopify trennt die Adresslogik von B2B und B2C zunehmend sauber.

Für Händler mit eigenentwickelten Payment-Integrationen lohnt der Blick in die aktuelle API-Referenz. Wer mit externen Payment-Apps arbeitet — etwa solchen für Rechnungskauf oder SEPA-Lastschrift im B2B — sollte beim Anbieter nachfragen, ob die neue Optionalität bereits eingebaut ist. Nicht jede Drittanbieter-App zieht bei solchen Schema-Änderungen sofort nach.

Der Umbau ist klein, die Wirkung unmittelbar: weniger abgebrochene B2B-Checkouts durch formale Adressfehler. Wer die Validierung jetzt nachzieht, spart sich Support-Tickets von Einkäufern, die an einem Feld scheitern, das fachlich nie hätte Pflicht sein dürfen. Die nächste Frage wird sein, ob USt-IdNr. und Firmenname künftig ähnlich konsistent behandelt werden — die Richtung stimmt.