We’ve added new payment error codes for subscription billing attempts in the GraphQL Admin API. These new error codes provide more granularity and consistency, making payment errors easier to diagnose. They’re currently available in the unstable API version, will be released in version 2026-04.
This is a companion discussion topic for the original entry at https://shopify.dev/changelog/new-payment-error-codes-added-to-subscriptions-apis