Release notes

Enhancements

• Clarified the need to enter a JSON formatted string for Shipper HQ metafields for product metafields and product variant metafields.

• Added error codes to the Get all customers and Delete customer endpoint descriptions. Thank you @sshaw.

Bug Fix

• Removed brackets to correct the Update a metafield request body for the Customers V3 API.

API

• The Upsert Customer Form Field Values endpoint is now deprecated. Use Update a Customer Address and Update Customers endpoints instead.

Developer Blog

• Script Authorization on Payment Pages: Understanding PCI 4.0 Section 6.4.3 and How We’re Providing The Tools To Keep Your Payment Pages Secure

Enhancements

• Updated the order_source description to be more specific regarding what values you can set for each origin. See the updated description in the response body for Get an order, Get all orders, Create an order, and Update an order endpoints as well as in the request body for Create an order and Update an order endpoints.

• Updated the is_customers_only description in the Pages API documentation to clarify that the page is only visible to logged-in customers.

Bug Fixes

• Added the order_source field as a request parameter for the Create an order and Update an order endpoints.

• Corrected the Update an order request example. Thank you @cjbarth.

• Fixed the rendering of the table in the Get all Order Statuses endpoint.

• Removed a legacy reference from the Using Event Hooks article because it is no longer valid. Thank you @bobmurdoch.

API

• We’re happy to announce the newly released Promotion Settings API.

• The V2 Orders API endpoints now include the is_tax_inclusive_pricing field in the response.

Catalyst

• Added a document about the Catalyst API Client. Learn how to fetch data from BigCommerce’s GraphQL Storefront API in Catalyst.

Enhancement

• Added security requirements developers can implement while creating an app. Now, you can deliver secure apps and keep clients safe. See the Submit your app for approval section for information.

Bug Fix

• Updated the subtotal_ex_tax description and other relevant Order and Product fields to clarify they can’t have a negative value. See Issue-512 for information.

API

• We’re happy to announce that we’ve added the following protected UI sections when you build a storefront channel. You can now include these settings when you create a channel menu: Overview, Localization, Script Manager, Payments, Checkout, Web pages and Data solutions.

• Updated the Form Fields endpoint of the REST Storefront API to include password requirements.

Enhancement

• Update the response schemas for the Checkout endpoints of the REST Storefront API.

Deprecations

• The following Stencil attributes are now deprecated and support for them will be dropped starting June 2025:

  • settings.request.is_crawler

  • settings.request.user_agent

  • settings.client_ip_address

  • settings.is_eu_ip_address

  • settings.region_code

Bug Fixes

• Clarified the text in Working with cart metafields to alleviate confusion. Cart metafields will not work with REST Storefront Carts.

• Clarified the descriptions for parent_id and tree_id in the Catalog > Category trees > Categories endpoints for creating a top-level category.

• Updated the description for is_customers_only in the Pages endpoint.

• Moved the Create a Webhook endpoint to Manage Webhooks (Single) since you can only create one webhook at a time.

API

• The newly-released Customer Segmentation API is generally available (GA) to use.

Stencil

• We updated Stencil React foundation documentation to work with the latest Babel plugin packages. Now, the guidance works for React 18.

Enhancements

• Clarified the role of the is_fallback boolean property of shipping methods, indicating when advanced shipping rules are unavailable.

• Added a Get a favicon example to the storefront example queries article.

Bug Fixes

• Corrected the consent category numbers in the Set Cookie Consent Preferences endpoint.

• Corrected the Content-Type for Catalog V3 image upload endpoints:

  • Create a brand image

  • Create a a category image

  • Create a product modifier image

  • Create a product variant image

  • Create a product image

API

• The Store Information API now includes the infrastructure_region of the store so you can determine the hosted store’s geographical location. This location is helpful when deploying supporting infrastructure for the store so you can deploy it nearby (or in the same GCP region) to minimize latency.

• We recently exposed the added_by_promotion field in the v3 cart and checkout endpoints.

Catalyst

• We’re happy to announce the newly released XML sitemap in Catalyst. You can now submit a complete BigCommerce sitemap to search engines for your Catalyst store.

Payments

• We’re happy to announce the update of the Braintree SDK version from 3.104.0 to 3.106.0 as of 4 PM EEST, September 4, 2024. See the Checkout SDK JS in GitHub for more information.

Bug Fix

• Updated the Create a Channel Site example from HTTP to HTTPS and added a note about using the HTTPS protocol.

API

We’re happy to announce that we have updated the Sites API reference to deprecate the ssl_status field. To determine whether a site uses a private or shared SSL, retrieve the status from the Site Certificate endpoint instead.

B2B

B2B Editions’s API reference documentation has now been moved into our Developer Center to provide a faster, more consistent experience for developers creating future B2B experiences. If you run into anything that we can improve, let us know!

Theme

The Stencil CLI tunnel option now contains a password field implemented by the tunnel provider to prevent abuse by malicious parties. Thank you, Jordan Ramsay.

Bug Fixes

• Added custom_provider_field_result to the response for the Get Order Transactions endpoint.

• Updated schema and query parameters for Storefront Carts endpoints.

• Added a sku_id field to the response for the Get Inventory at Locations endpoint.

Payments

• We are happy to announce the update of the Braintree SDK version from 3.95.0 to 3.104.0 as of 4 PM EEST, August 22, 2024. See the Checkout SDK JS in GitHub for more information.

API

• Updated the Create a Refund Quote endpoint of the Refund API to support product refund deductions

Enhancements

• Added undocumented webhook event types to webhook callbacks.

Bug Fixes

• Corrected the following endpoints:

  • Get Inventory at Locations

  • Get Store Information

  • Order Products

  • Order Shipments

API

• We are happy to announce that the Cart and Checkout API now supports optimistic concurrency control. This feature helps prevent lost updates caused by concurrent requests overriding changes made by others. If the version number provided by an API client does not match the version on the server, the request will be rejected, allowing the client to handle it accordingly.

• We added new formats for product codes upc, mpn, and gtin for Catalog V3 Products and Product variant APIs.

Themes

• Updated the Product Recommendations (Beta) docs. We now have reference code for Cornerstone available to modify your Stencil theme when you request recommendations.

Bug Fixes

• Corrected the Updated an order endpoint to specify that we remove discounts from line items changed in the request, not the whole order.

Enhancements

• We created a Create a Bulk Pricing Rule endpoint for our documentation. Thanks @altugyavuz7.