Skip to main content

What do billing attempt errors messages mean, and how do I resolve them?

Learn how to fix common billing attempt errors.

Updated over a week ago


Billing attempt errors explain why customer could not be successfully billed. This guide lists common error messages, what they mean, and what to do next.

To better understand how subscription billing works between Subi and Shopify, why payments fail, how customers update their payment method, how you’re notified, and how retries are handled, read our guide “Failed Subscription Payments – Causes, Notifications, and Fixes.”

If Billing recovery was enabled before the billing attempt failed, Subi will automatically retry the failed charge according to your configured retry rules. If Billing recovery was not enabled, Subi will not retry automatically, and you must reschedule the contract to trigger the next billing attempt.

Errors:

Inventory failure

Error codes

  • INSUFFICIENT_INVENTORY

Error message

One or more items on the order was out of stock so that the order couldn't be created.

What it means

Shopify checks stock levels before creating a new order. This error appears when inventory is tracked and there is not enough inventory to fill the order.

What to do next

In Shopify Admin, confirm inventory is available in Shopify.

If needed, go to Subi dashboard > Settings > Inventory & billing and review inventory-related behavior.

Additional related messages

  • Insufficient inventory.

Insufficient funds

Error codes

  • INSUFFICIENT_FUNDS

Error message

Payment gateway informed us that the customer's payment method does not have sufficient funds.

What it means

The customer did not have enough funds available to complete the purchase.

What to do next

  • Notify the customer to:

    • Add funds to their account, or

    • Update their payment method in the customer portal.

Additional related messages

  • [name of payment gateway] Response…Insufficient funds

  • [name of payment gateway] Response…Limit Exceeded

  • Charge total exceeds available credit balance. Additional payment method required to proceed.

  • Card declined

  • 2001 Insufficient Funds

  • Insufficient Funds

Card declined

Error codes

  • PAYMENT_METHOD_DECLINED

Error message

Payment gateway informed us that the customer's payment method was declined, for reasons unknown to us.

What it means

The payment gateway reported a decline, often without specific details.

What to do next

  • If the decline reason is included, use it for additional direction.

  • Some unclear failures may be resolved by retrying the billing. If retries fail, notify the customer to:

    • Remove and re-add the payment method, or

    • Update their payment method in the customer portal.

  • If a customer receives card decline errors periodically even after updating their card, they should contact their bank to investigate the issue. There might be a specific problem with their account that is preventing transactions from being processed.

  • Some card decline errors are unique to a payment processor. Review your payment processor’s help center for more information.

  • If the errors still persist after troubleshooting, or there is limited information in the error message:

    • Contact your payment processor support for further assistance.

Additional related messages

  • Card declined

  • Card has been declined

  • Processor Declined - Fraud Suspected

  • Processor Declined - Possible Lost Card

  • Processor Declined - Possible Stolen Card

  • Do Not Honor

  • Declined

  • Declined - Call Issuer

  • Lost card

  • Stolen card

  • Restricted card

  • Stop payment order

  • Card velocity exceeded

  • Pickup card

  • Pin try exceeded

  • Withdrawal count limit exceeded

  • Issuer not available

  • Not permitted

  • Invalid pin

  • Generic decline (Stripe, Braintree, Shopify Payments, Authorize)

  • Invalid account (Stripe, Braintree, Shopify Payments, Authorize)

  • Stolen card (Stripe, Braintree, Shopify Payments, Authorize)

  • Processor Declined - Fraud Suspected (Stripe, Braintree, Shopify Payments, Authorize)

  • Do not honor (Stripe, Braintree, Shopify Payments)

  • Try again later (Stripe, Braintree, Shopify Payments)

  • Pickup card (Stripe, Braintree, Shopify Payments)

  • Fraudulent (Stripe, Braintree, Shopify Payments)

  • Lost card (Stripe, Braintree, Shopify Payments)

  • Declined - Call Issuer (Stripe, Braintree, Shopify Payments)

  • Processor Declined - Possible Lost Card (Stripe, Braintree, Shopify Payments)

  • Invalid amount (Stripe, Shopify Payments, Authorize)

  • Processor Declined (Stripe, Shopify Payments, Authorize)

  • Declined (Stripe, Braintree, Shopify Payments, Authorize)

  • No Account (Stripe, Braintree, Shopify Payments)

  • Revocation of authorization (Stripe, Shopify Payments)

  • Card velocity exceeded (Stripe, Shopify Payments)

  • Restricted card (Stripe, Shopify Payments)

  • Reenter transaction (Stripe, Shopify Payments)

  • Your card’s security code is incorrect (Stripe, Shopify Payments)

  • Declined CVV (Braintree)

  • Processor Declined - Possible Stolen Card (Braintree)

  • Call issuer (Stripe, Braintree)

  • Invalid pin (Stripe)

  • Revocation of all authorizations (Stripe)

  • Card not supported (Stripe)

  • Issuer not available (Stripe)

  • Not permitted (Stripe)

  • Stop payment order (Stripe)

  • Withdrawal count limit exceeded (Stripe)

  • Pin try exceeded (Stripe)

  • Error code: 252 (Authorize) Authorize: “AFDS filter triggered; transaction held for merchant review”

  • Error code: 2 (Authorize) Authorize: “General decline by card issuing bank or by Merchant Service Provider”

  • Error code: 3 (Authorize) Authorize: “Referral to card issuing bank for verbal approval”

  • Error code: 4 (Authorize) Authorize: “Card reported lost or stolen; pick up card if physically available”

  • Error code: 5 (Authorize) Authorize: “A valid amount is required. The value submitted in the amount field did not pass validation for a number”

Payment method declined

Error codes

  • PAYMENT_METHOD_DECLINED

  • FRAUD_SUSPECTED

Error message

Shopify encountered an issue charging the customer's payment method.

What it means

Shopify could not process the charge for a variety of reasons, including suspected fraud or an inactive card.

What to do next

  • Shopify may retry processing automatically.

  • If the decline reason is included, use it for additional direction.

  • If the errors still persist after troubleshooting:

    • Contact Shopify support for further assistance.

Additional related messages

  • This transaction has been declined.

  • Gateway Rejected: fraud

  • Gateway Rejected: risk_threshold

  • Security Violation

  • Violation

  • Allowable number of PIN tries exceeded.

  • 2007 No Account" (Braintree)

  • 2014 Processor Declined - Fraud Suspected" (Braintree)

  • 2038 Processor Declined" (Braintree)

  • "2107 Card Not Activated" (Braintree)

  • "2108 Closed Card" (Braintree)

  • "2044 Declined - Call Issuer" (Braintree)

  • "2047 Call Issuer. Pick Up Card." (Braintree)

  • "Invalid amount." (Stripe, Shopify Payments, Braintree, Authorize.net)

  • "Cardmember not enrolled / not permitted"

  • "You have exceeded the maximum number of declines on this card in the last 24 hour period. Please contact us via https://support.stripe.com/contact if you need further assistance."

  • "Your card was declined."

  • "Your card was declined. Your request was in live mode, but used a known test card."

  • "Your card was declined. You can call your bank for details."

  • "Your card was declined for making repeated attempts too frequently or exceeding its amount limit."

  • "Your card is not supported."

  • "Your card is not supported. Please use a Visa, MasterCard, American Express, Discover, Diners Club, JCB, or UnionPay card"

  • "Your card does not support this type of purchase."

  • "CVV should have been present"

  • "Allowable number of PIN tries exceeded."

  • "This transaction has been declined."

  • "Instruct the customer to retry the transaction using an alternative payment method from the customers PayPal wallet. The transaction did not complete with the customers selected payment method."

Payment method revoked

Error codes

  • PAYMENT_METHOD_NOT_FOUND

  • BUYER_CANCELED_PAYMENT_METHOD

Error message

Shopify has revoked this payment method. The customer will need to replace it with a new, valid payment method.

What it means

The payment method was removed or revoked by Shopify. This commonly occurs when a customer deletes their payment method in Shop Pay.

What to do next

  • Notify the customer to update their payment method in the customer portal.

Additional related messages

  • UNPROCESSABLE_ENTITY, AGREEMENT_ALREADY_CANCELLED

  • Agreement was canceled

  • No payment token present on customer in Shopify

Card error general

Error codes

  • UNEXPECTED_ERROR

  • TRANSIENT_ERROR

  • PAYPAL_ERROR_GENERAL

Error message

Payment gateway informed us that something went wrong when trying to charge the customer's payment method, unrelated to the payment method itself.

What it means

A generic error occurred that is not directly caused by the payment method itself.

What to do next

  • If the decline reason is included, use it for additional direction.

  • Some unclear failures may be resolved by retrying the billing. If retries fail, notify the customer to:

    • Remove and re-add the payment method, or

    • Update their payment method in the customer portal.

  • If a customer receives card decline errors periodically even after updating their card, they should contact their bank to investigate the issue. There might be a specific problem with their account that is preventing transactions from being processed.

  • Some card decline errors are unique to a payment processor. Review your payment processor’s help center for more information.

  • If the errors still persist after troubleshooting, or there is limited information in the error message:

    • Contact your payment processor support for further assistance.

Additional related messages

  • UNPROCESSABLE_ENTITY, PAYEE_ACCOUNT_RESTRICTED

  • UNPROCESSABLE_ENTITY, PAYER_ACTION_REQUIRED

  • UNPROCESSABLE_ENTITY, TRANSACTION_REFUSED

  • An unexpected error occurred

  • Unexpected error communicating with Stripe.

  • There was an error processing the payment.

  • There was difficulty communicating with the payment system.

  • Unable to communicate with the payment system.

  • Server in maintenance. Please try again later

  • Duplicate Transaction

  • A payment method must be provided or already attached to the PaymentIntent when save_payment_method=true.

  • A source must be attached to a customer to be used as a payment_method

  • Address Verification Failed

  • An error occurred during processing. Call Merchant Service Provider.

  • An error occurred during processing. Please try again

  • An error occurred while processing your card.

  • An error occurred while processing your payment. Try again in a little bit or try a different payment method.

  • An unknown error occurred

  • Authorize Response Error: An error occurred during processing. Please try again.

  • Authorize Response Error: An error occurred during processing. Call Merchant Service Provider.

  • Authorize Response Error: Cannot Authorize at this time (Life cycle)

  • Authorize Response Error: Credit card expiration date is invalid.

  • Authorize Response Error: CVV should have been present

  • Authorize Response Error: No existing default PaymentMethod or Source in Stripe for this customer

  • Authorize Response Error: RecurringBilling setting is a required field for recurring tokenized payment transactions

  • Authorize Response Error: Server in maintenance. Please try again later

  • Authorize Response Error: The AnetApi/xml/v1/schema/AnetApiSchema.xsd:customerProfileId element is invalid - The value '' 1643841500'' is invalid according to its datatype AnetApi/xml/v1/schema/AnetApiSchema.xsd:numericString - The Pattern constraint failed Error code: None

  • Authorize Response Error: The AnetApi/xml/v1/schema/AnetApiSchema.xsd:customerProfileId element is invalid - The value ''`'' is invalid according to its datatype AnetApi/xml/v1/schema/AnetApiSchema.xsd:numericString - The Pattern constraint failed

  • Authorize Response Error: The AnetApi/xml/v1/schema/AnetApiSchema.xsd:name element is invalid - The value ''aI5rN4kwfZCj3yoaUg64Eb711734d6HePvU9ScMKzcRfV9jRaeaXYoV3W2GYvGtI'' is invalid according to its datatype String - The actual length is greater than the MaxLength value Error code: None

  • Authorize Response Error: The amount of this request was only partially approved on the given prepaid card. An additional payment is required to fulfill the balance of this transaction

  • Authorize Response Error: The configuration with processor is invalid. Call Merchant Service Provider.

  • Authorize Response Error: The credit card has expired.

  • Authorize Response Error: The FDC Merchant ID or Terminal ID is incorrect. Call Merchant Service Provider

  • Authorize Response Error: The merchant does not accept this type of credit card

  • Authorize Response Error: The VITAL identification numbers are incorrect. Call Merchant Service Provider.

  • Authorize Response Error: There was difficulty communicating with the payment system.

  • Authorize Response Error: This transaction cannot be accepted at this time

  • Authorize Response Error: This transaction has been declined.

  • Authorize Response Error: Unable to communicate with the payment system.

  • Authorize Response Error: Unable to process the purchase transaction.

  • Bill To First Name is required

  • Braintree Authorization Error

  • Braintree Response Error: Address Verification Failed

  • Braintree Response Error: Call Issuer. Pick Up Card.

  • Braintree Response Error: Cannot Authorize at this time (Life cycle)

  • Braintree Response Error: Cannot Authorize at this time (Policy)

  • Braintree Response Error: Card Not Activated

  • Braintree Response Error: Closed Card

  • Braintree Response Error: Customer does not have any credit cards.

  • Braintree Response Error: Customer ID is invalid.

  • Braintree Response Error: Do Not Honor

  • Braintree Response Error: Duplicate Transaction

  • Braintree Response Error: Funding Instrument In The PayPal Account Was Declined By The Processor Or Bank, Or It Can't Be Used For This Payment

  • Braintree Response Error: Gateway Rejected: duplicate

  • Braintree Response Error: Gateway Rejected: fraud

  • Braintree Response Error: Gateway Rejected: risk_threshold

  • Braintree Response Error: Invalid Amount

  • Braintree Response Error: Invalid Merchant ID

  • Braintree Response Error: Invalid Transaction Data

  • Braintree Response Error: Issuer or Cardholder has put a restriction on the card

  • Braintree Response Error: Merchant account does not support payment instrument.

  • Braintree Response Error: No Such Issuer

  • Braintree Response Error: Payer Account Is Locked Or Closed

  • Braintree Response Error: Payer Cannot Pay For This Transaction With PayPal

  • Braintree Response Error: Payment method token is invalid.

  • Braintree Response Error: PayPal Blocking Duplicate Order IDs

  • Braintree Response Error: PayPal Business Account Restricted

  • Braintree Response Error: PayPal Transaction Limit Exceeded

  • Braintree Response Error: PayPal Validation Failed

  • Braintree Response Error: Postal code can only contain letters, numbers, spaces, and hyphens.

  • Braintree Response Error: Postal code may contain no more than 9 letter or number characters.

  • Braintree Response Error: Security Violation

  • Braintree Response Error: US state codes must be two characters to meet PayPal Seller Protection requirements.

  • Braintree Response Error: Violation

  • Call Issuer. Pick Up Card.

  • Cannot Authorize at this time (Life cycle)

  • Cannot Authorize at this time (Policy)

  • Card Not Activated

  • Closed Card

  • Credit card expiration date is invalid.

  • Customer [token like cus_] does not have a linked source with ID [token like card_].

  • Customer does not have any credit cards.

  • Customer ID is invalid.

  • CVV should have been present

  • Do Not Honor

  • Duplicate Transaction

  • Error while communicating with one of our backends. Sorry about that! We have been notified of the problem. If you have any questions, we can help at https://support.stripe.com/.

  • Expired API Key provided: sk_live_kh****************************MDPY. Platform access may have been revoked.

  • Expired API Key provided: sk_test_ty****************************IuDv

  • Funding Instrument In The PayPal Account Was Declined By The Processor Or Bank, Or It Can't Be Used For This Payment

  • Gateway Rejected: application_incomplete

  • Gateway Rejected: duplicate

  • Gateway Rejected: fraud

  • Gateway Rejected: risk_threshold

  • Insufficient Funds

  • Invalid Amount

  • Invalid Merchant ID

  • Invalid Transaction Data

  • Issuer or Cardholder has put a restriction on the card

  • Merchant account does not support payment instrument.

  • No API key provided. (HINT: set your API key using "stripe.api_key = "). You can generate API keys from the Stripe web interface. See https://stripe.com/api for details, or email [email protected] if you have any questions.

  • No existing default PaymentMethod or Source in Stripe for this customer

  • No existing Subi PaymentMethod for this customer

  • No such customer: [token like cus_***]

  • No Such Issuer

  • No such PaymentMethod: [token like pm_***]; It's possible this PaymentMethod exists on one of your connected accounts, in which case you should retry this request on that connected account. Learn more at https://stripe.com/docs/connect/authentication

  • No such PaymentMethod: [token like pm_***]

  • No such PaymentMethod: [token like src_***]; It's possible this PaymentMethod exists on one of your connected accounts, in which case you should retry this request on that connected account. Learn more at https://stripe.com/docs/connect/authentication

  • Only active mandates can be used with PaymentIntents.

  • Payer Account Is Locked Or Closed

  • Payer Cannot Pay For This Transaction With PayPal

  • Payment method token is invalid.

  • PayPal Blocking Duplicate Order IDs

  • PayPal Business Account Restricted

  • PayPal Transaction Limit Exceeded

  • PayPal Validation Failed

  • Postal code can only contain letters, numbers, spaces, and hyphens.

  • Postal code may contain no more than 9 letter or number characters.

  • RecurringBilling setting is a required field for recurring tokenized payment transactions

  • Security Violation

  • Server in maintenance. Please try again later

  • Shopify_payments Response Error: An error occurred during processing. Please try again

  • Shopify_payments Response Error: An error occurred during processing. Call Merchant Service Provider

  • Shopify_payments Response Error: Call Issuer. Pick Up Card.

  • Shopify_payments Response Error: Cannot Authorize at this time (Life cycle)

  • Shopify_payments Response Error: Cannot Authorize at this time (Policy)

  • Shopify_payments Response Error: Closed Card

  • Shopify_payments Response Error: CVV should have been present

  • Shopify_payments Response Error: Do Not Honor

  • Shopify_payments Response Error: Funding Instrument In The PayPal Account Was Declined By The Processor Or Bank, Or It Can't Be Used For This Payment

  • Shopify_payments Response Error: Gateway Rejected: fraud

  • Shopify_payments Response Error: Gateway Rejected: risk_threshold

  • Shopify_payments Response Error: Invalid Merchant ID

  • Shopify_payments Response Error: Issuer or Cardholder has put a restriction on the card

  • Shopify_payments Response Error: No existing default PaymentMethod or Source in Stripe for this customer

  • Shopify_payments Response Error: Payer Cannot Pay For This Transaction With PayPal

  • Shopify_payments Response Error: The configuration with processor is invalid. Call Merchant Service Provider

  • Shopify_payments Response Error: The merchant does not accept this type of credit card

  • Shopify_payments Response Error: The VITAL identification numbers are incorrect. Call Merchant Service Provider

  • Shopify_payments Response Error: This transaction has been declined

  • Shopify_payments Response Error: Unable to communicate with the payment system.

  • Shopify_payments Response Error: Unable to process the purchase transaction.

  • Shopify_payments Response Error: Violation

  • Sorry, something went wrong. We've already been notified of the problem, but if you need any help, you can reach us at support.stripe.com/contact.

  • Stripe Response Error: An error occurred during processing. Please try again

  • Stripe Response Error: Call Issuer. Pick Up Card.

  • Stripe Response Error: Cannot Authorize at this time (Life cycle)

  • Stripe Response Error: Cannot Authorize at this time (Policy)

  • Stripe Response Error: Card Not Activated

  • Stripe Response Error: Closed Card

  • Stripe Response Error: Do Not Honor

  • Stripe Response Error: Duplicate Transaction

  • Stripe Response Error: Error while communicating with one of our backends. Sorry about that! We have been notified of the problem. If you have any questions, we can help at https://support.stripe.com/.

  • Stripe Response Error: Funding Instrument In The PayPal Account Was Declined By The Processor Or Bank, Or It Can't Be Used For This Payment

  • Stripe Response Error: Issuer or Cardholder has put a restriction on the card

  • Stripe Response Error: No existing default PaymentMethod or Source in Stripe for this customer

  • Stripe Response Error: No Such Issuer

  • Stripe Response Error: Payer Account Is Locked Or Closed

  • Stripe Response Error: Payer Cannot Pay For This Transaction With PayPal

  • Stripe Response Error: PayPal Blocking Duplicate Order IDs

  • Stripe Response Error: Security Violation

  • Stripe Response Error: Sorry, something went wrong. We've already been notified of the problem, but if you need any help, you can reach us at support.stripe.com/contact.

  • Stripe Response Error: The configuration with processor is invalid. Call Merchant Service Provider

  • Stripe Response Error: This transaction has been declined

  • Stripe Response Error: Unexpected error communicating with Stripe. If this problem persists,

  • Stripe Response Error: Violation

  • The amount of this request was only partially approved on the given prepaid card. An additional payment is required to fulfill the balance of this transaction

  • The configuration with processor is invalid. Call Merchant Service Provider

  • The credit card has expired.

  • The FDC Merchant ID or Terminal ID is incorrect. Call Merchant Service Provider

  • The Global Payment System identification numbers are incorrect. Call Merchant Service Provider

  • The merchant does not accept this type of credit card

  • The payment failed: Additional verification required from Link consumer. Please ask your customer to log into link.com to complete the necessary steps.

  • The payment failed.

  • The payment is blocked due to a high likelihood of chargeback. You can learn more about this at https://support.stripe.com/questions/sepa-debit-chargebacks-faq and if you need assistance processing a payment please contact us via https://support.stripe.com/contact/ for further information.

  • The PaymentMethod [token like pm_] does not belong to the Customer you supplied [token like cus_]. Please use this PaymentMethod with the Customer that it belongs to instead.

  • The PaymentMethod provided (card) is not allowed for this PaymentIntent. Please attach a PaymentMethod of one of the following types: sepa_debit. Alternatively, update the allowed payment_method_types for this PaymentIntent to include "card".

  • The PaymentMethod provided (sepa_debit) is not allowed for this PaymentIntent. Please attach a PaymentMethod of one of the following types: card. Alternatively, update the allowed payment_method_types for this PaymentIntent to include "sepa_debit".

  • The PaymentMethod provided (us_bank_account) is not allowed for this PaymentIntent. Please attach a PaymentMethod of one of the following types: card. Alternatively, update the allowed payment_method_types for this PaymentIntent to include "us_bank_account".

  • The provided mandate has a different payment method than the one provided on the PaymentIntent.

  • The provided PaymentMethod was previously used with a PaymentIntent without Customer attachment, shared with a connected account without Customer attachment, or was detached from a Customer. It may not be used again. To use a PaymentMethod multiple times, you must attach it to a Customer first.

  • The source that was attached to this PaymentIntent is no longer chargeable. You can try confirming again with a new source.

  • There was an unexpected error while processing your request. Please contact us via https://support.stripe.com/contact if the error persists.

  • There was difficulty communicating with the payment system.

  • This Connect account cannot currently make live charges. The requirements.disabled_reason property on the account will provide information about why this account is currently disabled. If you are a customer trying to make a purchase, please contact the owner of this site. Your transaction has not been processed.

  • This object cannot be accessed right now because another API request or Stripe process is currently accessing it. If you see this error intermittently, retry the request. If you see this error frequently and are making multiple concurrent requests to a single object, make your requests serially or at a lower rate.

  • This PaymentIntent requires a mandate, but no existing mandate was found. Collect mandate acceptance from the customer and try again, providing acceptance data in the mandate_data parameter.

  • This transaction cannot be accepted at this time.

  • This transaction has been declined

  • Unable to communicate with the payment system.

  • Unable to process the purchase transaction.

  • Unexpected error communicating with Stripe. If this problem persists,

  • US state codes must be two characters to meet PayPal Seller Protection requirements.

  • User authentication failed. The account or API user is inactive

  • Violation

  • You have exceeded the maximum number of declines on this card in the last 24 hour period. Please contact us via https://support.stripe.com/contact if you need further assistance.

  • Your account cannot currently make live charges. If you are the site owner, please activate your account at https://dashboard.stripe.com/account/onboarding to remove this limitation. If you are a customer trying to make a purchase, please contact the owner of this site. Your transaction has not been processed.

  • Your card could not be authorized using the postal code provided. Please update the postal code, or contact your card issuer for further details.

  • Your card's security code is invalid.

Invalid payment method

Error codes

  • INVALID_PAYMENT_METHOD

  • INVALID_CUSTOMER_BILLING_AGREEMENT

  • PAYMENT_METHOD_INCOMPATIBLE_WITH_GATEWAY_CONFIG

Error message

Payment gateway informed us that the payment method that was attempted is no longer valid. The customer will need to replace it with a new, valid payment method.

What it means

The customer can no longer use the payment method. This can happen if the customer closed their account or the card was flagged for potential fraud.

What to do next

  • Notify the customer to update their payment method in the customer portal.

Additional related messages

  • billing_agreement_not_found

  • billing_agreement_disabled

  • UNPROCESSABLE_ENTITY, BILLING_AGREEMENT_NOT_FOUND

  • Payment method token is invalid.

  • No existing Subi PaymentMethod for this customer

  • The PaymentMethod provided was previously used without Customer attachment.

  • The source that was attached to this PaymentIntent is no longer chargeable.

  • The PaymentMethod does not belong to the Customer supplied.

  • 2001 Insufficient Funds

  • Address not verified

  • credit_card_not_found

  • CVV should have been present

  • Instruct the customer to retry the transaction using an alternative payment method from the customers PayPal wallet. The transaction did not complete with the customers selected payment method.

  • No such PaymentMethod: [token like card_***]

  • No such PaymentMethod: [token like pm_***]

  • No such paymentmethod: [token like pm_***]; a similar object exists in live mode, but a test mode key was used to make this request.

  • Street address and postal code do not match. For American Express: Card member's name, street address and postal code do not match.

  • System unavailable.

  • The credit card number is invalid.

  • The totals of the cart item amounts do not match order amounts. This transaction cannot be processed.

  • The transaction has been declined because of an AVS mismatch. The address provided does not match billing address of cardholder.

  • The value of Description/Next steps parameter has been truncated. Instruct the customer to retry the transaction using an alternative payment method from the customers PayPal wallet. The transaction did not complete with the customers selected payment method.

  • The value of Description/Next steps parameter has been truncated. Transaction failed but user has alternate funding source

  • The zip code you supplied failed validation.

  • This payment method cannot be used on an address that uses a currency different than [currency symbol].

  • This transaction has been declined.

  • Transaction failed but user has alternate funding source

  • User's account is closed or restricted

  • Your card could not be authorized using the postal code provided. Please update the postal code, or contact your card issuer for further details.

  • Your card number is incorrect.

  • Your card's security code is incorrect.

  • Your card's security code is invalid.

Purchase type not supported by card

Error codes

  • PURCHASE_TYPE_NOT_SUPPORTED

Error message

Payment gateway informed us that the customer's payment method does not allow purchases like this subscription. The customer will need to reach out to their bank for more details or replace the existing payment method with a new payment method.

What it means

The customer’s card does not allow subscription purchases.

What to do next

  • Notify the customer to update their payment method in the customer portal.

  • The customer can contact their bank for details.

Additional related messages

  • Your card does not support this type of purchase.

  • Transaction Not Allowed

Card expired

Error codes

  • EXPIRED_PAYMENT_METHOD

Error message

Payment gateway informed us that the customer's payment method has expired and can no longer be used. The customer will need to replace it with a new, valid payment method.

What it means

The payment gateway confirmed the card has expired.

What to do next

  • Notify the customer to update their payment method in the customer portal.

Additional related messages

  • 2004 Expired Card

  • Expired Card

  • The credit card has expired.

  • Your card's expiration month is invalid

  • Your card's expiration year is invalid

  • Authorize Response Error: Credit card expiration date is invalid

  • Authorize Response Error: The credit card has expired

  • Authorize Response Error: The credit card has expired Error code: 8

  • Authorize Response Error: User authentication failed due to invalid authentication values Error code: 7

  • Authorize Response Error: User authentication failed. The account or API user is inactive Error code: 8

  • Braintree Response Error: Expired Card

  • Credit card expiration date is invalid

  • Expired Card

  • Stripe Response Error: Expired Card

  • The credit card has expired

  • Your card has expired

Expired payment method

Error codes

  • EXPIRED_PAYMENT_METHOD

Error message

Shopify has informed us that the customer's payment method has expired and can no longer be used. The customer will need to replace it with a new, valid payment method.

What it means

Shopify confirmed the payment method on file expired.

What to do next

  • Notify the customer to update their payment method in the customer portal.

Additional related messages

  • 2004 Expired Card

  • Credit card expiration date is invalid

  • Field: api_errors Error: credit_card_is_expired

  • The credit card has expired

  • Your card has expired

  • Your card's expiration month is invalid

  • Your card's expiration year is invalid

Unexpected error

Error codes

  • UNEXPECTED_ERROR

  • TRANSIENT_ERROR

Error message

Payment gateway informed us that something went wrong when trying to charge the customer's payment method, unrelated to the payment method itself. We will automatically try again.

What it means

A rare processing issue occurred, sometimes due to temporary system or network-level problems.

What to do next

  • If the decline reason is included, use it for additional direction:

    • If the error message contains “failed to create orders,” manually retry the charge to see if the error resolves. Click the three dots next to the Error column and select Retry charge.

    • If the unexpected error includes “bad request,” check your platform’s discount codes. Determine if any outdated discount code or discounts from your ecommerce platform caused the error.

    • If the error message reads “ShopifyInvalidShippingPhone - BAD REQUEST,” a recent Shopify update may be the cause. This error occurs if your Shopify checkout settings require a phone number for the shipping address.To find this setting, go to Shopify Admin, select Settings, click Checkout, and scroll to Customer information. If the phone number field is blank, this will trigger an UNEXPECTED_ERROR.

Customer needs to update card

Error codes

  • INVALID_PAYMENT_METHOD

  • BUYER_CANCELED_PAYMENT_METHOD

Error message

Payment gateway informed us that the customer's payment method can no longer be used. The customer will need to replace it with a new, valid payment method.

What it means

The customer’s card is no longer valid for recurring billing.

What to do next

  • Notify the customer to update their payment method in the customer portal.

Additional related messages

  • Authorize Response Error: PayPal Buyer Revoked Pre-Approved Payment Authorization

  • Braintree Response Error: Cardholder Stopped All Billing

  • Braintree Response Error: Cardholder Stopped Billing

  • Braintree Response Error: PayPal Buyer Revoked Pre-Approved Payment Authorization

  • Cardholder Stopped All Billing

  • Cardholder Stopped Billing

  • No payment token present on customer in Shopify

  • Shopify_payments Response Error: PayPal Buyer Revoked Pre-Approved Payment Authorization

  • Stripe Response Error: Cardholder Stopped All Billing

  • Stripe Response Error: PayPal Buyer Revoked Pre-Approved Payment Authorization

Card zip code failed validation

Error codes

  • INVALID_PAYMENT_METHOD

Error message

Payment gateway informed us that the customer's payment method can no longer be used. The customer will need to replace it with a new, valid payment method.

What it means

Zip or postal code validation failed because billing address details did not match.

What to do next

  • Verify the customer’s billing address and correct the zip or postal code if needed.

  • Retry the billing attempt.

  • If it fails again, notify the customer to:

    • Remove and re-add the payment method, or

    • Update their payment method in the customer portal.

  • "The zip code you supplied failed validation" error:

    This error means the ZIP code entered at checkout does not match the one on file with the customer’s credit card company. If you have enabled the Shopify Payments setting to decline charges when ZIP code verification fails, any mismatch will cause the payment to be declined.

    ​

    Contact the customer and ask them to confirm the ZIP code registered with their card issuer. Have them update their billing address in their account or with their bank, then retry the payment.

    If appropriate for your business, you can disable strict ZIP code verification in Shopify:

    Go to Settings > Payments in Shopify.

    In the Shopify Payments section, click Manage.

    Under Fraud prevention, uncheck the ZIP code verification requirement.

Note: Authorize.net may use the same error code for other address-related issues.

Additional related messages

  • Authorize Response Error: CVV should have been present Error code: 27

  • Authorize Response Error: Street address and postal code do not match. For American Express: Card member's name, street address and postal code do not match. Error code: 27

  • Authorize Response Error: Street address does not match, but 5-digit postal code matches. Error code: 27

  • Authorize Response Error: Street address matches, but postal code does not match. Error code: 27

  • Authorize Response Error: System unavailable. Error code: 27

  • Authorize Response Error: The transaction has been declined because of an AVS mismatch. The address provided does not match billing address of cardholder. Error code: 27

  • The zip code you supplied failed validation

Card number incorrect

Error codes

  • CARD_NUMBER_INCORRECT

  • INVALID_PAYMENT_METHOD

Error message

Payment gateway informed us that the customer's card number is incorrect and can no longer be used. The customer will need to replace it with a new, valid payment method.

What it means

The card number is invalid.

What to do next

  • Notify the customer to update their payment method in the customer portal.

Additional related messages

  • Authorize Response Error: CVV does not match

  • Authorize Response Error: The credit card number is invalid

  • Authorize Response Error: The credit card number is invalid. Error code: 6

  • CVV does not match

  • Shopify_payments Response Error: CVV does not match

  • Shopify_payments Response Error: The credit card number is invalid

  • Stripe Response Error: The credit card number is invalid

  • The credit card number is invalid

  • Your card number is incorrect

Buyer canceled payment method

Error codes

  • BUYER_CANCELED_PAYMENT_METHOD

Error message

Shopify informed us that the customer cancelled their payment method and that it can no longer be used. The customer will need to replace it with a new, valid payment method.

What it means

This commonly occurs when a customer cancels their PayPal authorization outside of Subi or Shopify.

What to do next

  • Notify the customer to update their payment method in the customer portal.

Additional related messages

  • Agreement was canceled

Payment provider is not enabled

Error codes

  • PAYMENT_PROVIDER_IS_NOT_ENABLED

Error message

Shopify informed us that the configured payment provider is not enabled. Review Shopify payment provider settings for the store.

What it means

Your payment provider settings in Shopify are not correctly configured.

What to do next

  • Review your Shopify payment provider settings.

When you change your payment processor in Shopify, you’ll likely encounter errors related to payment processors that aren’t connected. This is because your existing subscriptions are linked to the old processor that has been removed.

Due to Shopify’s limitations, migrating payment tokens from the old payment processor to the new one isn’t possible. To resolve the “payment processors are not enabled” errors, you have three options:

Option 1: Re-add Payment Processor

You can re-add your old payment processor to Shopify to ensure that existing subscribers continue to process payments as expected. However, after re-adding the old payment processor, you’ll need to manually retry the charge.

Option 2: Add Payment Processor as a Legacy Payment Gateway

You can add your old payment processor as a legacy payment gateway. This option ensures that your existing subscribers continue to process payments, while new customers are processed through the new payment processor. Again, after adding the old payment processor, you’ll need to manually retry the charge.

Option 3: Advise Customers to Go Through Checkout

If connecting your old payment processor in Shopify isn’t an option, you’ll need to advise your existing customers to go through the checkout. This is because the initial payment token creation needs to take place within the Shopify Checkout.

For more detailed information about setting up payment processors on Shopify Checkout, please reach out to Shopify Support.

Additional related messages

  • Payment provider is not enabled on the shop

Payment method not found

Error codes

  • PAYMENT_METHOD_NOT_FOUND

Error message

Payment gateway informed us that the customer's payment method is no longer available. The customer will need to replace it with a new, valid payment method.

What it means

The customer does not have a valid payment method on file.

What to do next

  • Notify the customer to update their payment method in the customer portal, or

  • Cancel their subscription and proceed to checkout using a new payment method.

Additional related messages

  • Payment method is not ready

  • Payment method was revoked

  • Unable to find PaymentMethod for Address [number]

Customer not found

Error codes

  • CUSTOMER_INVALID

Error message

Payment gateway informed us that they have no customer account matching what we provided.

What it means

There is no matching customer account on file with your payment gateway.

What to do next

  • Contact your payment gateway for additional information and to resolve the issue.

Additional related messages

Authorize.net specific errors:

  • Customer Profile ID is invalid

  • Customer Profile ID or Customer Payment Profile ID not found

  • Usually means that the customer has been removed from authorize.net

No such customer: [token like cus_***]

Authentication error

Error codes

  • AUTHENTICATION_ERROR

  • TEST_MODE

Error message

Payment gateway informed us that the authentication keys provided were not valid.

What it means

The payment gateway was not set up correctly in your Shopify store.

What to do next

  • Review your payment gateway configuration and ensure the correct authentication keys and values have been provided. Make sure not to use test/staging keys for live environment and vice versa.

Additional related messages

  • Account is locked or inactive

  • Account is restricted

  • Authentication failed

  • Authentication needed

  • Authorize Response Error: User authentication failed due to invalid authentication values

  • Authorize Response Error: User authentication failed due to invalid authentication values Error code: 7

  • Braintree Authorization Error braintree informed us that the authentication keys provided were not valid.

  • Expired API Key provided: [key like sk_test_************]

  • No such customer: [token like cus_***]; a similar object exists in test mode, but a live mode key was used to make this request.

  • Shopify_payments Response Error: No API key provided. (HINT: set your API key using "stripe.api_key = "). You can generate API keys from the Stripe web interface. See https://stripe.com/api for details, or email [email protected] if you have any questions.

  • Stripe Response Error: Expired API Key provided: [key like sk_live_************]. Platform access may have been revoked.

  • Stripe Response Error: Expired API Key provided: [key like sk_test_************]

  • Stripe Response Error: No API key provided. (HINT: set your API key using "stripe.api_key = "). You can generate API keys from the Stripe web interface. See https://stripe.com/api for details, or email [email protected] if you have any questions.

  • User authentication failed due to invalid authentication values

  • Username/Password is incorrect

  • You do not have permissions to make this API call

Payment failure - invalid phone number

Error codes

  • INVALID_SHIPPING_ADDRESS

Error message

Payment gateway informed us that the shipping phone number associated with the customer's order is invalid.

What it means

The shipping phone number is invalid.

What to do next

  • Update the customer's shipping phone number and try again.

Payment failure - invalid discount amount

Error codes

  • UNEXPECTED_ERROR

Error message

Payment gateway informed us that the discount on the customer's order is invalid.

What it means

The discount amount was invalid.

What to do next

  • The discount amount must be greater than $0 (or 0%).

  • Update or remove the discount code and try again.

Payment failure - invalid zip code

Error codes

  • INVALID_SHIPPING_ADDRESS

Error message

Payment gateway informed us that the shipping address zip code is invalid/blank.

What it means

The shipping zip or postal code is invalid or blank.

What to do next

  • Update the zip or postal code on the shipping address and try again.

Payment failure - invalid shipping province

Error codes

  • INVALID_SHIPPING_ADDRESS

Error message

Payment gateway informed us that the shipping address province field is invalid/blank.

What it means

The shipping province is invalid or blank.

What to do next

  • Add a shipping province on the shipping address and try again.

Payment failure - invalid country

Error codes

  • INVALID_SHIPPING_ADDRESS

Error message

Payment gateway informed us that the shipping address country is invalid.

What it means

The shipping country is invalid.

What to do next

  • Update the country on the shipping address and try again.

Payment failure - invalid pickup location

Error codes

  • INVALID_SHIPPING_ADDRESS

Error message

Payment gateway informed us that the chosen pick up location is invalid.

What it means

The pickup location is invalid.

What to do next

  • Subi retains the delivery method a customer selects at checkout throughout the length of a subscription and customers cannot change their delivery method within the customer portal.

  • The customer must complete a new checkout order and select a valid shipping or pickup location.

Payment failure - invalid discount

Error codes

  • UNEXPECTED_ERROR

Error message

Payment gateway informed us that the discount on the customer's order is invalid.

What it means

The discount code is invalid.

What to do next

  • Update or remove the discount code and try again.

Contract not available error

Error codes

  • CONTRACT_UNDER_REVIEW

  • CUSTOMER_INVALID

Error message

Shopify_payments informed us that there is no subscription contract associated with this address.

What it means

A sync issue occurred between Subi and Shopify. In rare cases, a delay or webhook failure can prevent the contract from being created.

What to do next

  • Contact Subi support to restore the sync between Subi and Shopify.

Non test order limit reached

Error codes

  • NON_TEST_ORDER_LIMIT_REACHED

  • TEST_MODE

What it means

The Shopify store reached the limit of 50 non-test transactions.

What to do next

  • A Shopify store admin must switch the Shopify Payments gateway to test mode to continue processing test charges.

  • Billing attempts with this error need to be manually retried after Shopify settings are updated.

Potential fraud

Error codes

  • CONTRACT_UNDER_REVIEW

What it means

Shopify prevents Subi from creating a new order when it flags the checkout order as potential fraud.

What to do next

  • Review the checkout order linked to the subscription.

  • If it is fraudulent, cancel the order.

  • If it is not fraudulent, contact Shopify to remove the fraud flag from the original order and manually retry the billing attempt.

  • See Shopify documentation for more details.

Fraud suspected

Error codes

  • FRAUD_SUSPECTED

What it means

Shopify may mark an order as potentially fraudulent if it encounters an issue charging the customer’s payment method.

What to do next

  • Review the customer’s order history.

  • If the order is fraudulent, cancel the customer’s subscription.

  • If the order is not fraudulent, manually retry the billing attempt.

  • If this issue persists, contact Shopify Support with the billing attempt ID and ask them to investigate.

  • See Shopify documentation for more details on fraud analysis.

Unexpected inventory level

Error codes

  • INVENTORY_ALLOCATIONS_NOT_FOUND

Error message

One or more items on the order was out of stock, so the order couldn't be created.

What it means

This can happen when products are shipped but are not assigned to a valid shipping profile for the correct inventory location in Shopify.

What to do next

Use one of these methods:

Inventory allocations not found

Error codes

  • INVENTORY_ALLOCATIONS_NOT_FOUND

What it means

Inventory at the given location could not be found for one or more items. This can happen when products are not assigned to a valid shipping profile for the correct inventory location in Shopify.

What to do next

Use one of these methods:

Amount too small

Error codes

  • AMOUNT_TOO_SMALL

Error message

Payment gateway informed us that the charge amount is below the minimum amount allowed for this currency or payment method.

What it means

The billing attempt failed because the total amount Subi attempted to collect is below the minimum charge amount allowed by the payment processor (often due to currency conversion minimums, very small order totals, or discounts reducing the total too far).

What to do next

  • Review the billing attempt Message field to confirm the minimum amount requirement.

  • Increase the order total so it meets the gateway minimum (for example, remove or adjust a discount, add an item, or update the pricing).

  • Retry the billing attempt.

Related decline messages

  • The transaction amount is below the minimum amount allowed for this payment method.

  • Amount must be at least £0.30 gbp

  • Charge amount must be at least $0.50 usd

  • Amount must convert to at least 30 pence. 12.00 sek converts to 0.91 gbp.

  • Amount must convert to at least 50 cents. $0.22 usd converts to $0.213128 cad.

Need Help

Feel free to contact our support team. We're here for you anytime:
Live Chat: Message us from within the Subi app or your Shopify Admin.
Email: Reach us at [email protected].

Related Articles
How do I create a discount code for Shopify subscription purchases?
How do I prepare my Stripe subscriptions for migration to Subi?
Failed Subscription Payments – Causes, Notifications, and Fixes
How do I prepare the Subi Migration Template for my subscription data?
Why am I seeing the "Inventory Allocations Not Found" error on my subscription contract?
Did this answer your question?