Changelog

GraphQL Schema Updates

Customers can now retrieve their stored payment instruments through the Storefront GraphQL API, plus a new top-level category search filter and a translatable brand URL path resource.

Storefront GraphQL

• Stored payment instruments: new storedPaymentInstruments connection field on the Customer type returns an authenticated customer’s saved cards, PayPal accounts, and bank accounts. Filter the results by payment method with StoredPaymentInstrumentsFiltersInput, and read the customer’s default instrument from defaultStoredPaymentInstrumentToken on the connection.
  • Authentication: the field requires a valid customer JWT. The parent customer query resolves to null for unauthenticated requests.
  • Connection types: StoredPaymentInstrumentConnection, StoredPaymentInstrumentEdge, and the StoredPaymentInstrumentDetails union (StoredCard, StoredPaypalAccount, StoredBankAccount).
  • Instrument types: StoredCard (with StoredCardExpiry and StoredCardBillingAddress), StoredBankAccount, and StoredPaypalAccount.
• Top-level category filter: new topLevelOnly boolean on SearchProductsFiltersInput that returns only visible top-level categories, omitting any reachable only through a hidden or disabled parent

Admin GraphQL

• Brand URL path translations: new BRAND_URL_PATHS value on the TranslationResourceType enum

Resources

• Query a customer’s stored payment instruments in the Customers guide
• Storefront GraphQL API reference
• Admin GraphQL API reference