Wer im B2B-Checkout den Nachnamen des Einkäufers erzwingt, verliert Orders. Genau hier setzt eine stille, aber folgenreiche Änderung an der Shopify Payments Apps API an: Bei B2B-Bestellungen ist das Feld family_name in shipping_address und billing_address nicht mehr verpflichtend. Payment-Apps, die diesen Wert bislang hart validieren, brechen B2B-Transaktionen ab, sobald ein Firmenkunde ohne Personenbezug bestellt.
Der Hintergrund ist struktureller Natur. B2B-Checkouts laufen nicht über eine natürliche Person, sondern über ein Unternehmen. Rechnungsadressen tragen häufig nur Firmenname, Abteilung und USt-IdNr. Der Vorname und Nachname eines Sachbearbeiters fehlen schlicht, weil die Bestellung zentral vom Einkauf ausgelöst wird. Shopify hat diese Logik im B2B-Checkout bereits umgesetzt. Die Payments Apps API zieht nun nach.
family_name als Nullable-Feld behandeln — sonst scheitern B2B-Payment-Sessions an einer Validierung, die der Checkout selbst gar nicht mehr verlangt.Was sich konkret in der API ändert
Die Änderung betrifft die Payment-Session-Requests, die Apps über die Payments Apps API an Shopify senden. In den Adressobjekten shipping_address und billing_address darf family_name künftig entfallen. Die API akzeptiert Requests ohne dieses Feld, sofern der Kontext eine B2B-Order ist.
Für Shopbetreiber heißt das zunächst wenig — es sei denn, sie setzen eine Payment-App ein, die selbst Validierungslogik mitbringt. Genau dort liegt das Risiko. Viele Payment-Anbieter prüfen eingehende Adressdaten gegen eigene Schemata, bevor sie eine Zahlung autorisieren. Erwartet ein solches Schema zwingend einen Nachnamen, schlägt die Session fehl. Der Kunde sieht eine Fehlermeldung, der Kauf bricht ab, und im schlimmsten Fall wandert die Bestellung zum Wettbewerber.
Warum Payment-Anbieter jetzt nachbessern müssen
Wer eine Payment-App oder ein Checkout-Modul für Shopify Plus mit B2B-Funktion betreibt, sollte die eigene Validierung prüfen. Konkret: Wird family_name im Request-Handler als Pflichtfeld behandelt? Falls ja, ist der B2B-Fall nicht abgedeckt. Anbieter, die ihre Adapter nach der alten Spezifikation gebaut haben, liefern dann falsche Fehler zurück, obwohl die Bestellung valide ist. Das ist kein Randfall — B2B-Bestellungen ohne persönlichen Nachnamen sind im Firmenkunden-Geschäft die Regel, nicht die Ausnahme.
B2B ist kein B2C mit größerer Bestellmenge. Wer Adressfelder wie im Endkunden-Checkout erzwingt, baut eine Conversion-Bremse in die eigene Payment-Kette.
Entwickler-Teams sollten dabei nicht nur die Validierung entschärfen. Ebenso wichtig ist die nachgelagerte Verarbeitung: Rechnungsstellung, ERP-Übergabe und Fraud-Checks dürfen nicht davon ausgehen, dass ein Nachname existiert. Ein leerer family_name sollte durch den Firmennamen oder die Kundennummer als Identifikationsmerkmal aufgefangen werden. Shopify-Plus-Händler mit einem B2B-Kanal auf demselben Shop wie dem D2C-Geschäft profitieren hier besonders, weil beide Modelle nun dieselbe Adresslogik bedienen können.
Wie sollten Händler auf die Änderung reagieren?
Der erste Schritt ist eine Bestandsaufnahme. Welche Payment-Apps laufen im Shopify-Backend, und stammen sie aus einer Quelle, die aktiv gepflegt wird? Bei Drittanbieter-Apps lohnt ein Blick in die Changelogs oder eine direkte Rückfrage beim Support. App-Anbieter, die regelmäßig Versionen pflegen — etwa im Umfeld von Shopify Plus B2B — haben die Anpassung meist schon eingebaut oder planen sie kurzfristig.
Shopbetreiber ohne eigene Entwicklungsressourcen sollten das Thema nicht auf die lange Bank schieben. Die Umstellung ist klein, die Wirkung auf abgebrochene B2B-Kaufvorgänge dagegen erheblich. Wer viele Firmenkunden mit zentralem Einkauf bedient, merkt das direkt in der Conversion-Rate des B2B-Kanals. Testbestellungen mit reinen Firmenadressen ohne Ansprechpartner liefern schnell Aufschluss, ob die eigene Payment-Kette die Änderung bereits abbildet.