Tags:
- Admin GraphQL API
- 2026-04
Subscriptions APIs: Introduce SubscriptionBillingAttemptState
As of April 2026, you now have access to the field in the GraphQL Admin API. This new field replaces several loosely-typed nullable fields with a discriminated union pattern, enhancing the API's ergonomics and self-documentation.
| Deprecated Field | New Equivalent | Notes |
|---|---|---|
| errorCode | FailedState.error.code | Error codes now categorized into Payment, Inventory, General, and Unexpected errors |
| errorMessage | FailedState.error.message | Explicit messages now only on UnexpectedError; other types use typed codes |
| nextActionUrl | ActionRequiredState.action.nextActionUrl | Now also includes status (OFF_SESSION_REJECTED / ON_SESSION_CHALLENGED) |
| order | SuccessState.order | Same Order type, scoped to success state |
| processingError | FailedState.error | Replaced by typed SubscriptionBillingAttemptError union |
| ready | PendingState.processing | Instead of a boolean, check whether state is PendingState |
Find details about the schema in the documentation.
Was this section helpful?