---
title: >-
  INVALID_BILLING_ADDRESS: new processing error for subscription billing
  attempts - 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/subscription-billing-attempt-invalid-billing-address-error
  md: >-
    https://shopify.dev/changelog/posts/subscription-billing-attempt-invalid-billing-address-error.md
metadata:
  effectiveApiVersion: 2026-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-11-13T12:08:39-05:00'
  postedAt: '2026-01-01T12:00:00-05:00'
  updatedAt: '2025-11-14T11:08:29-05:00'
  effectiveAt: '2025-11-14T12:00:00-05:00'
---

January 1, 2026

# `INVALID_BILLING_ADDRESS`: new processing error for subscription billing attempts

DateJanuary 1, 2026

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

FlagsNew

SurfacesAPI

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

We've added a new processing error for subscription billing attempts: [`INVALID_BILLING_ADDRESS`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SubscriptionBillingAttemptProcessingError#possible-types-SubscriptionBillingAttemptGenericError.fields.code.INVALID_BILLING_ADDRESS).

This error is returned when one or more fields in the billing address contain invalid data. Validated fields include:

* `firstName` or `lastName`
* `address1` or `address2`
* `city`
* `province` or `provinceCode`
* `country` or `countryCode`
* `zip` (postal code)
* `phone`
* `company`