API, B2B, Stencil, and Catalyst
What’s New
Cleaner APIs (refund quote simplification, shipping cost comparisons, Cart image_url, batch metafield filters), tighter webhook/tax requirements, and an updated Payments Postman collection.
B2B docs clarify authentication and pending-company behavior, Stencil guidance aligns to INP, and Catalyst onboarding details redirected checkout + MSF.
Dive into the notes below for the full rundown.
API
The merchant_calculated_override field was eliminated from the POST /refund_quote request to reduce confusion. It is only applicable when submitting the final refund (POST /refunds).
Introduced comparisonShippingCost and shippingCostBeforeDiscount within order.consignments.shipping to enable clearer pre/post discount shipping cost visibility.
image_url is now documented in the V3 Cart POST response, aligning POST with existing GET behavior.
Products and Product Variants batch metafields endpoints now support the resource_id:in query parameter for more precise bulk retrieval.
Opening section refined to better direct users to in-depth guides and clarify usage patterns.
Added explicit requirement that tax provider API URLs must use HTTPS.
Payments API “Run in Postman” link now points to a shared collection including an example for stored bank accounts.
Documentation updated to state webhooks no longer persist after API account deletion, preventing orphaned integrations.
B2B
All authentication reference links updated to target correct endpoint sections
Documented storefront experience and restrictions for customers whose Company applications are pending after using the Create Company endpoint.
Stencil
Replaced references to First Input Delay (FID) with Interaction to Next Paint (INP) in Stencil theme creation guidance to reflect new performance standards.
Catalyst
Expanded guidance around redirected checkout and Multi-Storefront (MSF) requirements to reduce setup confusion.
