---
title: SubscriptionBillingAttemptPaymentErrorCode - GraphQL Admin
description: Error codes for payment-related billing attempt failures.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionBillingAttemptPaymentErrorCode
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionBillingAttemptPaymentErrorCode.md
api_name: admin
api_type: graphql
type: enum
metadata:
  domain: admin
---

# Subscription​Billing​Attempt​Payment​Error​Code

enum

Error codes for payment-related billing attempt failures.

## Valid values

* AMOUNT\_​TOO\_​LARGE

  The transaction amount is too large.

* AMOUNT\_​TOO\_​SMALL

  The transaction amount is too small.

* AUTHENTICATION\_​ERROR

  There was an error during the authentication.

* AUTHENTICATION\_​FAILED

  Authentication failed during the payment processing.

* AUTHENTICATION\_​REQUIRED

  Additional authentication is required for this payment.

* BUYER\_​CANCELED\_​PAYMENT\_​METHOD

  The buyer canceled the payment method.

* CALL\_​ISSUER

  The card issuer requires the cardholder to call.

* CANCELLED\_​PAYMENT

  The payment was cancelled.

* CARD\_​DECLINED

  The card was declined.

* CARD\_​NUMBER\_​INCORRECT

  The card number is incorrect.

* CONFIRMATION\_​REJECTED

  The payment confirmation was rejected.

* DO\_​NOT\_​HONOR

  The card issuer returned 'do not honor'. The customer should reach out to their card-issuing bank for more information.

* EXPIRED\_​BUYER\_​ACTION

  The required buyer action has expired.

* EXPIRED\_​CARD

  The card has expired.

* EXPIRED\_​PAYMENT\_​METHOD

  Payment method has expired.

* FRAUD\_​SUSPECTED

  Fraud was suspected on this transaction.

* GENERIC\_​ERROR

  A generic payment error occurred.

* INCORRECT\_​ADDRESS

  The billing address is incorrect.

* INCORRECT\_​NUMBER

  The card number is incorrect.

* INCORRECT\_​ZIP

  The postal/ZIP code is incorrect.

* INSUFFICIENT\_​FUNDS

  The payment method has insufficient funds to complete the payment.

* INVALID\_​CURRENCY

  The currency is not supported.

* INVALID\_​CUSTOMER\_​BILLING\_​AGREEMENT

  The customer billing agreement is invalid.

* INVALID\_​EXPIRY\_​DATE

  The expiry date is invalid.

* INVALID\_​NUMBER

  The card number is invalid.

* INVALID\_​PAYMENT\_​METHOD

  Payment method is invalid.

* INVALID\_​PURCHASE\_​TYPE

  The purchase type is invalid.

* INVALID\_​SHIPPING\_​ADDRESS

  The shipping address is invalid.

* INVOICE\_​ALREADY\_​PAID

  The invoice has already been paid.

* MERCHANT\_​RULE

  The payment was declined due to a merchant rule.

* OFF\_​SESSION\_​REJECTED

  The off-session payment was rejected.

* PAYMENT\_​METHOD\_​DECLINED

  Payment method was declined.

* PAYMENT\_​METHOD\_​UNSUPPORTED

  The payment method type is not supported.

* PAYMENT\_​PROVIDER\_​ERROR

  An exception occurred with the payment provider.

* PAYPAL\_​ERROR\_​GENERAL

  A general PayPal error occurred.

* PROCESSING\_​ERROR

  A processing error occurred.

* PURCHASE\_​TYPE\_​NOT\_​SUPPORTED

  Purchase type is not supported.

* RETRY\_​DECLINED

  The payment retry was declined.

* TEST\_​MODE

  A test mode error occurred.

* TRANSACTION\_​LIMIT\_​EXCEEDED

  The transaction exceeded the limit.

* TRANSIENT\_​ERROR

  A transient error occurred, try again later.

***

## Fields

* [Subscription​Billing​Attempt​Payment​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptPaymentError#field-SubscriptionBillingAttemptPaymentError.fields.code)

  OBJECT

  A payment-related error that occurred during a subscription billing attempt.

***

## Map

### Fields with this enum

* [Subscription​Billing​Attempt​Payment​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptPaymentError#field-SubscriptionBillingAttemptPaymentError.fields.code)