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

• Removed unsupported field from Refund Quote endpoint

  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).

• Added new shipping cost comparison fields

  Introduced comparisonShippingCost and shippingCostBeforeDiscount within order.consignments.shipping to enable clearer pre/post discount shipping cost visibility.

• Cart API enhancement

  image_url is now documented in the V3 Cart POST response, aligning POST with existing GET behavior.

• Metafields batch filtering

  Products and Product Variants batch metafields endpoints now support the resource_id:in query parameter for more precise bulk retrieval.

• Webhooks specification context

  Opening section refined to better direct users to in-depth guides and clarify usage patterns.

• HTTPS enforcement note for tax provider API

  Added explicit requirement that tax provider API URLs must use HTTPS.

• Postman collection update

  Payments API “Run in Postman” link now points to a shared collection including an example for stored bank accounts.

• Webhook lifecycle clarity

  Documentation updated to state webhooks no longer persist after API account deletion, preventing orphaned integrations.

B2B

• Hosted storefront authentication maintenance

  All authentication reference links updated to target correct endpoint sections

• Pending Company account behavior

  Documented storefront experience and restrictions for customers whose Company applications are pending after using the Create Company endpoint.

Stencil

• Core Web Vitals update

  Replaced references to First Input Delay (FID) with Interaction to Next Paint (INP) in Stencil theme creation guidance to reflect new performance standards.

Catalyst

• Catalyst onboarding clarity

  Expanded guidance around redirected checkout and Multi-Storefront (MSF) requirements to reduce setup confusion.