---
title: SubscriptionBillingAttemptState - GraphQL Admin
description: The state of a subscription billing attempt with state-specific data.
api_version: 2026-04
api_name: admin
type: union
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionBillingAttemptState
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionBillingAttemptState.md
metadata:
  domain: admin
---

# Subscription​Billing​Attempt​State

union

Requires `read_own_subscription_contracts` access scope.

The state of a subscription billing attempt with state-specific data.

## Fields with this union

* [Subscription​Billing​Attempt.state](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttempt#field-SubscriptionBillingAttempt.fields.state)

  OBJECT

  A record of an execution of the subscription billing process. Billing attempts use idempotency keys to avoid duplicate order creation.

  When a billing attempt completes successfully, it creates an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order). The attempt includes associated payment transactions and any errors that occur during billing. If 3D Secure authentication is required, the `nextActionUrl` field provides the redirect URL for customer verification.

***

```graphql
union SubscriptionBillingAttemptState = SubscriptionBillingAttemptActionRequiredState | SubscriptionBillingAttemptFailedState | SubscriptionBillingAttemptPendingState | SubscriptionBillingAttemptSuccessState
```