--- title: SubscriptionBillingAttemptErrorCode - GraphQL Admin description: >- The possible error codes associated with making billing attempts. The error codes supplement the `error_message` to provide consistent results and help with dunning management. api_version: 2026-10 source_url: html: >- https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionBillingAttemptErrorCode md: >- https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionBillingAttemptErrorCode.md api_name: admin api_type: graphql type: enum --- # Subscription​Billing​Attempt​Error​Code enum The possible error codes associated with making billing attempts. The error codes supplement the `error_message` to provide consistent results and help with dunning management. ## Valid values * AMOUNT\_​TOO\_​LARGE The amount exceeds the limit for this payment method. * AMOUNT\_​TOO\_​SMALL The amount is too small. * AUTHENTICATION\_​ERROR There was an error during the payment authentication. * AUTHENTICATION\_​FAILED Authentication failed during payment processing. * AUTHENTICATION\_​REQUIRED Additional authentication is required to complete the payment. * BUYER\_​CANCELED\_​PAYMENT\_​METHOD Payment method was canceled by buyer. * CALL\_​ISSUER The card issuer requires the cardholder to call them. * CANCELLED\_​PAYMENT The payment was cancelled. * CARD\_​DECLINED The card was declined by the payment processor. * CARD\_​NUMBER\_​INCORRECT Card number was incorrect. * CONFIRMATION\_​REJECTED The payment confirmation was rejected. * CUSTOMER\_​INVALID Customer is invalid. * CUSTOMER\_​NOT\_​FOUND Customer was not found. * DO\_​NOT\_​HONOR The card issuer declined the transaction with a 'do not honor' response. * EXPIRED\_​BUYER\_​ACTION The required buyer action has expired. * EXPIRED\_​CARD The card has expired. * EXPIRED\_​PAYMENT\_​METHOD Payment method is expired. * FRAUD\_​SUSPECTED Fraud was suspected. * FREE\_​GIFT\_​CARD\_​NOT\_​ALLOWED Gift cards must have a price greater than zero. * GENERIC\_​ERROR A generic payment error occurred. * INCORRECT\_​ADDRESS The billing address provided is incorrect. * INCORRECT\_​CVC The card security code entered is incorrect. * INCORRECT\_​NUMBER The card number entered is incorrect. * INCORRECT\_​PIN The PIN entered is incorrect. * INCORRECT\_​ZIP The postal/ZIP code provided is incorrect. * INSUFFICIENT\_​FUNDS Insufficient funds. * INSUFFICIENT\_​INVENTORY Not enough inventory found. * INVALID\_​AMOUNT The transaction amount is invalid for this payment method. * INVALID\_​BILLING\_​ADDRESS The billing address is invalid. * INVALID\_​CURRENCY The currency is not supported for this payment method. * INVALID\_​CUSTOMER\_​BILLING\_​AGREEMENT The billing agreement ID or the transaction ID for the customer's payment method is invalid. * INVALID\_​CVC The card security code is invalid. * INVALID\_​EXPIRY\_​DATE The expiry date of the card provided is invalid. * INVALID\_​NUMBER The card number is invalid. * INVALID\_​PAYMENT\_​METHOD Payment method is invalid. Please update or create a new payment method. * INVALID\_​PURCHASE\_​TYPE The purchase type is invalid for this payment method. * INVALID\_​REQUEST The payment request is invalid. * INVALID\_​SHIPPING\_​ADDRESS The shipping address is either missing or invalid. * INVENTORY\_​ALLOCATIONS\_​NOT\_​FOUND No inventory location found or enabled. * INVOICE\_​ALREADY\_​PAID A payment has already been made for this invoice. * MERCHANT\_​ACCOUNT\_​ERROR Merchant account configuration error. * MERCHANT\_​RULE The transaction was declined due to a merchant-defined rule. * NON\_​TEST\_​ORDER\_​LIMIT\_​REACHED Non-test order limit reached. Use a test payment gateway to place another order. * OFF\_​SESSION\_​REJECTED The off-session payment was rejected and requires customer action. * PAYMENT\_​METHOD\_​DECLINED Payment method was declined by processor. * PAYMENT\_​METHOD\_​INCOMPATIBLE\_​WITH\_​GATEWAY\_​CONFIG Payment method cannot be used with the current payment gateway test mode configuration. * PAYMENT\_​METHOD\_​NOT\_​FOUND Payment method was not found. * PAYMENT\_​METHOD\_​NOT\_​SPECIFIED Payment method is not specified on subscription contract. * PAYMENT\_​METHOD\_​UNSUPPORTED The payment method type is not supported. * PAYMENT\_​PROVIDER\_​ERROR An exception occurred with the payment provider. * PAYMENT\_​PROVIDER\_​IS\_​NOT\_​ENABLED Payment provider is not enabled. * PAYPAL\_​ERROR\_​GENERAL Paypal Error General. * PROCESSING\_​ERROR A processing error occurred with the payment provider. * PURCHASE\_​TYPE\_​NOT\_​SUPPORTED Purchase Type is not supported. * RETRY\_​DECLINED The payment retry was declined. * TEST\_​MODE Gateway is in test mode and attempted to bill a live payment method. * TRANSACTION\_​LIMIT\_​EXCEEDED The transaction exceeds the cardholder's limit. * TRANSIENT\_​ERROR Transient error, try again later. * UNEXPECTED\_​ERROR There was an unexpected error during the billing attempt. *** ## Fields * [Subscription​Billing​Attempt​Generic​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptGenericError#field-SubscriptionBillingAttemptGenericError.fields.code) OBJECT A base error type that applies to all uncategorized error classes. * [Subscription​Billing​Attempt​Insufficient​Stock​Product​Variants​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptInsufficientStockProductVariantsError#field-SubscriptionBillingAttemptInsufficientStockProductVariantsError.fields.code) OBJECT An inventory error caused by an issue with one or more of the contract merchandise lines. * [Subscription​Billing​Attempt​Out​Of​Stock​Product​Variants​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptOutOfStockProductVariantsError#field-SubscriptionBillingAttemptOutOfStockProductVariantsError.fields.code) OBJECT An inventory error caused by an issue with one or more of the contract merchandise lines. * [Subscription​Billing​Attempt​Processing​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SubscriptionBillingAttemptProcessingError#fields-code) INTERFACE An error that prevented a billing attempt. * [Subscription​Billing​Attempt.errorCode](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttempt#field-SubscriptionBillingAttempt.fields.errorCode) OBJECT Deprecated *** ## Map ### Fields with this enum * [Subscription​Billing​Attempt​Generic​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptGenericError#field-SubscriptionBillingAttemptGenericError.fields.code) * [Subscription​Billing​Attempt​Insufficient​Stock​Product​Variants​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptInsufficientStockProductVariantsError#field-SubscriptionBillingAttemptInsufficientStockProductVariantsError.fields.code) * [Subscription​Billing​Attempt​Out​Of​Stock​Product​Variants​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttemptOutOfStockProductVariantsError#field-SubscriptionBillingAttemptOutOfStockProductVariantsError.fields.code)