---
title: SubscriptionBillingAttempt - GraphQL Admin
description: >-
  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.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttempt
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttempt.md
---

# Subscription​Billing​Attempt

object

Requires `read_own_subscription_contracts` access scope.

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.

## Fields

* completedAt
* createdAt
* id
* idempotencyKey
* originTime
* paymentGroupId
* paymentSessionId
* respectInventoryPolicy
* subscriptionContract
* transactions

### Deprecated fields

* errorCode: deprecated
* errorMessage: deprecated
* nextActionUrl: deprecated
* order: deprecated
* processingError: deprecated
* ready: deprecated

***

## Map

### Fields and connections with this object

* [SubscriptionBillingAttemptConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SubscriptionBillingAttemptConnection#returns-nodes)
* [SubscriptionBillingAttemptEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptEdge#field-SubscriptionBillingAttemptEdge.fields.node)
* [SubscriptionBillingCycle.billingAttempts](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycle#field-SubscriptionBillingCycle.fields.billingAttempts)
* [SubscriptionContract.billingAttempts](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.billingAttempts)

***

## Queries

* subscriptionBillingAttempt
* subscriptionBillingAttempts

***

## SubscriptionBillingAttempt Queries

### Queried by

* [subscription​Billing​Attempt](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionBillingAttempt)
* [subscription​Billing​Attempts](https://shopify.dev/docs/api/admin-graphql/latest/queries/subscriptionBillingAttempts)

***

## Mutations

* subscriptionBillingAttemptCreate
* subscriptionBillingCycleCharge

***

## SubscriptionBillingAttempt Mutations

### Mutated by

* [subscription​Billing​Attempt​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingAttemptCreate)
* [subscription​Billing​Cycle​Charge](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionBillingCycleCharge)

***

## Interfaces

* Node

***

## SubscriptionBillingAttempt Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)