Cart and checkout validation adds billing address and PO number error targets
Shopify's 2026-04 API adds billing address and PO number validation targets to Cart and Checkout Functions, enabling server-side enforcement of B2B compliance rules like blocking prohibited billing countries or requiring PO numbers. Impacts Shopify merchants running B2B or wholesale operations.
For agencies managing Shopify B2B clients, this eliminates the fragile client-side workaround for PO number enforcement — meaning fewer failed wholesale orders and cleaner AR workflows. Audit any existing UI extension handling PO or billing validation and migrate logic to Functions before client-side patches break on checkout updates.
Shopify continues deepening native B2B infrastructure, reducing reliance on third-party apps and custom workarounds — part of a broader platform consolidation push that compresses agency differentiation in wholesale checkout builds.
If you manage Shopify B2B storefronts: check Checkout Functions in the Shopify Partner Dashboard — if PO number validation is currently client-side, migrate it to a server-side Function now to prevent compliance gaps.
Within 30 days, update your checkout validation Function to include $.cart.poNumber and $.cart.billingAddress targets using API version 2026-04 to enforce billing country restrictions without relying on UI extensions.
Bottom Line
Shopify B2B checkout validation now enforces PO and billing rules server-side.
Source Lens
Technical Platform Update
Official but usually technical. Useful only when the change affects merchant-facing operations.
Impact Level
medium
Shopify B2B checkout validation now enforces PO and billing rules server-side.
Key Stat / Trigger
No single quantitative trigger surfaced in this report.
Focus on the operational implication, not just the headline.
Full Coverage
Back to Developer changelog April 1, 2026 Tags: Functions 2026-04 Cart and checkout validation adds billing address and PO number error targets Ask assistant As of API version 2026-04, you can validate billing addresses and purchase order (PO) numbers in Cart and Checkout Validation Functions.
We've added billing address and PO Number to the function input graph and introduced new checkout field targets. This allows you to enforce compliance rules such as blocking prohibited billing countries and requiring PO numbers for B2B orders without relying upon client-side UI extensions.
What's changed Input graph fields: billingAddress and poNumber are available on all Shopify Function input graphs. They return null outside of Cart and Checkout Validation. Supported checkout field targets for error messages in Cart and Checkout Validation: $. cart. billing Address. {field} (all standard address subfields) $. cart.
po Number Impact No breaking changes. Your existing functions continue to run. You can optionally add validations for these targets. Checkout surfaces field-level errors for billing address and PO number when your function returns validations for these targets. To learn more, see the developer documentation. Was this section helpful? Yes No
Original Source
This briefing is based on reporting from Shopify Developer Changelog. Use the original post for full primary-source context.
Style
Audience