detektu
Shopify API changes
Info

family_name is optional for B2B orders in Payments Apps API requests

doc:019fb619-9b4a-74ac-a83e-3ffa98844fb4::feed/https://shopify.dev/changelog/family_name-is-optional-for-b2b-orders-in-payments-apps-api-requests
Product
Shopify Admin GraphQL API
Source
Feed
Change kind
Feed Entry
Detected
Last updated

Deterministic evidence

Before / after

Extracted from Shopify's published contract. Open the source ↗

−1+81 change

1 / 1
null
{
"content_hash": "343a1a49f5d61a1067976c515afa506c9a315f97e056c9a0bb9e270bfe8c50aa",
"excerpt": "B2B checkout treats the buyer’s surname as optional, so payment session requests for B2B orders can omit family_name in shipping_address and billing_address. This affects payments apps that handle B2B orders through the Payments Apps API and currently require family_name in these addresses. 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…",
"identity": "https://shopify.dev/changelog/family_name-is-optional-for-b2b-orders-in-payments-apps-api-requests",
"link": "https://shopify.dev/changelog/family_name-is-optional-for-b2b-orders-in-payments-apps-api-requests",
"published_at": "2026-09-15T16:00:00Z",
"title": "family_name is optional for B2B orders in Payments Apps API requests"
}

Interpreted documentation change

What the vendor announced

The evidence indicates a documentation changelog entry stating that family_name is optional for B2B orders in Payments Apps API requests, meaning B2B checkout no longer requires the buyer’s surname in shipping_address and billing_address for payment session requests. This is an informational change describing a relaxed requirement in the API usage.

family_name is optional for B2B orders in Payments Apps API requests B2B checkout treats the buyer’s surname as optional, so payment session requests for B2B orders can omit family_name in shipping_address and billing_address. This affects payments apps that handle B2B orders through the Payments Apps API and currently require family_name in these addresses. 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…

Vendor source ↗

Monitored for you

Does this change affect your integration?

Choose the operations and fields your services use. Detektu matches Shopify findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.

Monitor Shopify free See pricing

Multi-source correlation

Other Shopify findings correlated with this change across sources.

  1. Potentially breaking
    SDK release 15.0.0sdk:npm/@shopify/shopify-api@15.0.0
    Shopify Admin GraphQL API
  2. Potentially breaking
    SDK release 15.0.0sdk:npm/@shopify/shopify-api@15.0.0
    Shopify Admin GraphQL API