Skip to navigation

Filter wallet shipping options in custom checkouts

Custom checkout implementations based on checkout-js can control which shipping options appear in Apple Pay, Google Pay, and Stripe Link V2 wallet interfaces.

  • Shipping option callback — pass filterAvailableShippingOptions from a custom wallet component to return the rates that the wallet supports.
  • Selection synchronization — when filtering removes the selected rate, the Checkout SDK selects the recommended rate or the first remaining rate.
  • Error fallback — if the callback rejects or throws an error, the wallet displays the unfiltered shipping options.
  • SDK support — use @bigcommerce/checkout-sdk version 1.978.0 or later for all three wallets.

For details, see Filter wallet shipping options.


GraphQL Schema Updates

The root company query on the Storefront GraphQL API is now deprecated. B2B company data lives under the authenticated customer’s activeCompany context, introduced in July, and integrations should migrate to it.

Storefront GraphQL

  • Query.company deprecated: query customer { activeCompany { ... } } instead. The ActiveCompany type exposes the same addresses, address, and orders fields as CompanyQueries.
  • CompanyQueries.addresses deprecated: use customer { activeCompany { addresses { ... } } }. Pagination, CompanyAddressFiltersInput filtering, and CompanyAddressSortInput sorting are unchanged.
  • No behavior change today: the deprecated fields continue to resolve. A sunset date has not been set; migrate before removal is announced.

For schema details, browse the Storefront GraphQL API reference.