---
title: >-
  RETRY_DECLINED added to CustomerPaymentMethodRevocationReason - 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/retry_declined-added-to-customerpaymentmethodrevocationreason
  md: >-
    https://shopify.dev/changelog/posts/retry_declined-added-to-customerpaymentmethodrevocationreason.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-11-03T11:47:32-05:00'
  postedAt: '2026-11-04T12:00:00-05:00'
  updatedAt: '2026-11-05T07:06:57-05:00'
  effectiveAt: '2026-11-04T12:00:00-05:00'
---

November 4, 2026

# RETRY\_DECLINED added to CustomerPaymentMethodRevocationReason

DateNovember 4, 2026

FlagsUpdate

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

As of GraphQL Admin API version`2027-01`, [`CustomerPaymentMethod.revokedReason`](https://shopify.dev/docs/api/admin-graphql/2027-01/enums/CustomerPaymentMethodRevocationReason) can return a new value: `RETRY_DECLINED`. Shopify uses this value when a subscription payment method is revoked because the payment processor has blocked any further retry attempts. On earlier API versions, these revocations continue to return `TOO_MANY_CONSECUTIVE_FAILURES`.

If your app reads `CustomerPaymentMethod.revokedReason` using API version 2027-01, use `RETRY_DECLINED` to indicate to merchants and buyers that the processor has blocked further charges to the saved payment method and that a different payment method is required.

The `customer_payment_methods/revoke` webhook payload is unchanged. After receiving the webhook, query `CustomerPaymentMethod.revokedReason` to determine whether the payment method was revoked because of `RETRY_DECLINED` or `TOO_MANY_CONSECUTIVE_FAILURES`.