family_name is optional for B2B orders in Payments Apps API requests
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 15, 2026.
This Shopify update is categorized as API, Update, Payments Apps API.
What changed
B2B checkout doesn’t require a buyer surname, and the Payments Apps API already accepts payment session requests for B2B orders without family_name in the shipping_address or billing_address. The Payments app request reference now documents family_name as optional for B2B orders to match this behavior.
Who is affected
Payments apps that use the Payments Apps API to process B2B checkouts and validate that shipping_address.family_name or billing_address.family_name is always present are affected. Payments apps that already accept requests without family_name for B2B orders don’t need to change anything.
What action may be needed
If your app currently requires family_name in the shipping_address or billing_address for B2B orders, update your validation so it accepts payment session requests where that field is absent for B2B checkouts. Confirm that your app still behaves as expected when family_name is present or missing in these addresses. Related docs Payments app request reference
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →