---
title: >-
  Improved billing attempt error handling for subscriptions in Selling Plan API
  - 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/posts/improved-billing-attempt-error-handling-for-subscriptions-in-selling-plan-api
  md: >-
    https://shopify.dev/changelog/posts/improved-billing-attempt-error-handling-for-subscriptions-in-selling-plan-api.md
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2024-10-10T19:36:34-04:00'
  postedAt: '2024-12-11T08:00:00-05:00'
  updatedAt: '2024-12-09T14:26:46-05:00'
  effectiveAt: '2024-12-11T08:00:00-05:00'
---

December 11, 2024

# Improved billing attempt error handling for subscriptions in Selling Plan API

DateDecember 11, 2024

Version[2025-01](https://shopify.dev/changelog?api_version=2025-01)

FlagsUpdate

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

Following the [release](https://shopify.dev/changelog/subscription-billing-attempt-now-respects-inventory-policy-to-not-allow-overselling) of subscription billing attempt respecting merchant’s inventory policy to prevent overselling, we added new features to assist developers in managing billing errors.

As of 2025-01, when accessing billing error details during billing attempts, you can now leverage [processingError](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/SubscriptionBillingAttempt#field-processingerror) to identify specific product variants responsible for inventory errors. This update provides better insight into failed billing attempts related to inventory issues by integrating location-specific inventory data directly within the error diagnostics.

Learn more about the [Selling Plan API inventory policy](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/subscriptionBillingAttemptCreate#top).