---
title: >-
  Subscription Billing Attempt is now prevented if a subscription contract has
  terminal status - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/subscription-billing-attempt-is-now-prevented-if-a-subscription-contract-has-terminal-status
  md: >-
    https://shopify.dev/changelog/subscription-billing-attempt-is-now-prevented-if-a-subscription-contract-has-terminal-status.md
metadata:
  effectiveApiVersion: 2024-01
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: true
  createdAt: '2023-11-29T16:19:57-05:00'
  postedAt: '2024-01-01T00:00:00-05:00'
  updatedAt: '2024-12-13T17:24:40-05:00'
  effectiveAt: '2024-01-01T00:00:00-05:00'
---

[Back to Developer changelog](https://shopify.dev/changelog)

January 1, 2024

Tags:

* Action Required
* API
* 2024-01

# Subscription Billing Attempt is now prevented if a subscription contract has terminal status

As of the **2024-01** release of the GraphQL Admin API, the [`SubscriptionBillingAttemptCreate`](https://shopify.dev/docs/api/admin-graphql/2024-01/mutations/subscriptionBillingAttemptCreate) mutation now prevents the creation of Billing Attempts if a subscription contract has a terminal status: `EXPIRED`, `CANCELLED`, `STALE`.

We've also added the [`CONTRACT_TERMINATED`](https://shopify.dev/docs/api/admin-graphql/2024-01/enums/BillingAttemptUserErrorCode#value-contractterminated) error code to the `BillingAttemptUserErrorCode` enum. This new error code is returned in the case where Billing Attempt creation is prevented.

Learn more about the Subscription Contracts API and Billing Attempts on [Shopify.dev](https://shopify.dev/docs/apps/selling-strategies/subscriptions/contracts/create#step-4-create-a-billing-attempt).