Skip to main content

Payment errors

Learn how to identify and troubleshoot common payment errors in Loop to ensure smooth subscription billing and improved payment success.

In this guide, we’ll walk you through the common payment-related errors that can pop up with subscription orders and give you simple troubleshooting steps to get everything back on track.

Payment errors table

Loop places scheduled subscription orders on behalf of your customers on Shopify, passing essential information including the payment token. If the payment does not go through, Shopify returns an error code explaining why.

In April 2026, Shopify released a new set of payment error codes for subscription billing attempts as part of API version 2026-04. These new codes provide more granularity and consistency, making it easier to diagnose why a payment failed. Refer to Shopify's changelog and subscription billing attempt error codes for the full details of this release.

Error codes on Loop after April 2026

The table below applies to payment errors applicable after April 2026, following Shopify's updated error code system.

Shopify code

Loop failure reason

Description

AMOUNT_TOO_LARGE

Amount too large

The transaction amount exceeds the limit allowed by the payment provider or card issuer.

AMOUNT_TOO_SMALL

Amount too small

The transaction amount is below the minimum required by the payment provider.

AUTHENTICATION_ERROR, AUTHENTICATION_FAILED, AUTHENTICATION_REQUIRED, CONFIRMATION_REJECTED, 3DS_CHALLENGE_EXPIRED_LOOP

3DS authentication failed

The card requires 3D Secure authentication, but the process failed, was rejected, or expired before completion.

BUYER_CANCELED_PAYMENT_METHOD

PayPal agreement cancelled

The customer cancelled their PayPal payment agreement, preventing future charges.

CALL_ISSUER, CARD_DECLINED, PAYMENT_METHOD_DECLINED

Card declined

The payment was rejected by the bank or card issuer. This can happen for a range of reasons including fraud detection, account restrictions, or spending limits.

CANCELLED_PAYMENT

Billing agreement cancelled

The subscription billing agreement was cancelled or revoked by the customer or payment provider.

CARD_NUMBER_INCORRECT, INCORRECT_NUMBER, INVALID_NUMBER

Incorrect card number

The card number on file is not valid or does not match the issuer's records.

CUSTOMER_INVALID, CUSTOMER_NOT_FOUND

Invalid customer

The customer record could not be found or is no longer valid in Shopify.

DO_NOT_HONOR

Do not honor

The card issuer declined the transaction without providing a specific reason. This is a generic decline instruction from the bank.

EXPIRED_BUYER_ACTION, GENERIC_ERROR, OFF_SESSION_REJECTED, UNEXPECTED_ERROR

Some error occurred

An unspecified error occurred during payment processing. Contact Shopify support for further investigation.

EXPIRED_CARD, EXPIRED_PAYMENT_METHOD, INVALID_EXPIRY_DATE

Card expired

The card or payment method on file has passed its expiration date.

FRAUD_SUSPECTED, MERCHANT_RULE, CONTRACT_UNDER_REVIEW

Fraud suspected

The transaction was flagged as potentially fraudulent by the payment provider or a merchant rule.

FREE_GIFT_CARD_NOT_ALLOWED

Invalid gift card amount

Gift cards cannot be used for this type of transaction.

INCORRECT_ADDRESS, INCORRECT_ZIP, INVALID_BILLING_ADDRESS, INVALID_SHIPPING_ADDRESS

Invalid address

The billing or shipping address on file does not match the issuer's records or is incomplete.

INSUFFICIENT_FUNDS

Insufficient funds

The customer's account does not have enough funds to complete the transaction.

INSUFFICIENT_INVENTORY

Insufficient inventory

The product does not have enough stock available to fulfill the subscription order.

INVALID_CURRENCY

Invalid currency

The currency used for the transaction is not supported by the payment provider.

INVALID_CUSTOMER_BILLING_AGREEMENT

PayPal agreement invalid

The PayPal billing agreement on file is no longer valid or has expired.

INVALID_PAYMENT_METHOD

Invalid payment method

The payment method on file is not valid or cannot be used for this transaction.

INVALID_PURCHASE_TYPE, PAYMENT_METHOD_UNSUPPORTED, PURCHASE_TYPE_NOT_SUPPORTED

Card type not supported

The card type or payment method is not supported for this kind of purchase.

INVENTORY_ALLOCATIONS_NOT_FOUND

No inventory location found

The payment failed because no active inventory location could be found or the shipping address is not serviceable.

INVOICE_ALREADY_PAID

Invoice already paid

The invoice for this order has already been paid and cannot be charged again.

MERCHANT_ACCOUNT_ERROR

Merchant account error

There is an issue with the merchant's payment account configuration. Contact your payment provider.

NON_TEST_ORDER_LIMIT_REACHED, PAYMENT_METHOD_INCOMPATIBLE_WITH_GATEWAY_CONFIG, TEST_MODE

Gateway test mode error

The payment gateway is in test mode, or a test payment method was used in a live environment, preventing the transaction from being processed.

PAYMENT_METHOD_NOT_FOUND, PAYMENT_METHOD_NOT_SPECIFIED

Payment method revoked

The payment method has been removed or revoked and can no longer be charged.

PAYMENT_PROVIDER_ERROR, PROCESSING_ERROR

Payment provider error

A technical error occurred on the payment provider's side during processing.

PAYMENT_PROVIDER_IS_NOT_ENABLED

Payment provider not enabled

The payment provider is not enabled on the store. Check your Shopify payment settings.

PAYPAL_ERROR_GENERAL

PayPal general error

A general error occurred with PayPal. Ask the customer to retry or use an alternative payment method.

RETRY_DECLINED

Card retry declined

A retry attempt for a previously declined card was also declined by the issuer.

TRANSACTION_LIMIT_EXCEEDED

Transaction limit exceeded

The transaction exceeds the limit set by the payment provider or card issuer.

TRANSIENT_ERROR

Transient error

A temporary error occurred on the payment network. The transaction can usually be retried.

SHOPIFY_DECLINED, SHOPIFY_NO_CONFIRMATION

Shopify declined

Shopify declined the payment or did not receive confirmation. Contact Shopify support for more details.

Payment errors and troubleshooting steps

  1. Amount too large: This error occurs when the transaction amount exceeds the limit set by the payment provider or card issuer.
    ​

    Error messages: "AMOUNT_TOO_LARGE"
    ​

    Troubleshooting steps:

    • Check if the subscription order value has changed unexpectedly due to price updates or quantity changes.

    • Ask the customer to contact their bank to raise their transaction limit, or suggest they switch to a payment method with a higher limit.
      ​

  2. Amount too small: This error occurs when the transaction amount is below the minimum required by the payment provider.
    ​

    Error messages: "AMOUNT_TOO_SMALL"
    ​

    Troubleshooting steps:

    • Review the subscription order value to confirm it meets the payment provider's minimum transaction threshold.

    • If the amount is intentionally small (e.g. due to a discount), contact your payment provider to adjust the minimum transaction limit.
      ​

  3. 3DS authentication failed: This error occurs when the card requires 3D Secure authentication but the process failed, was rejected, or expired before the customer could complete it.
    ​

    Error messages: "AUTHENTICATION_ERROR," "AUTHENTICATION_FAILED," "AUTHENTICATION_REQUIRED," "CONFIRMATION_REJECTED," "3DS_CHALLENGE_EXPIRED_LOOP"
    ​

    Troubleshooting steps:

    • Send a payment update email to the customer via the Loop subscription admin portal and ask them to re-authenticate their card.

    • Ask the customer to check with their bank whether 3DS is enabled for recurring payments on their card.

    • If the issue persists, ask the customer to use an alternative payment method that does not require 3DS.
      ​

  4. PayPal agreement cancelled: This error occurs when the customer has cancelled their PayPal payment agreement, preventing future charges.
    ​

    Error messages: "BUYER_CANCELED_PAYMENT_METHOD"
    ​

    Troubleshooting steps:

    • Ask the customer to set up a new PayPal billing agreement or switch to an alternative payment method.

    • Send a payment update email to the customer via the Loop subscription admin portal.
      ​

  5. Card declined: This error occurs when the payment is rejected by the bank or card issuer. This can happen for a range of reasons including fraud detection, account restrictions, or spending limits.
    ​

    Error messages: "CALL_ISSUER," "CARD_DECLINED," "PAYMENT_METHOD_DECLINED"
    ​

    Troubleshooting steps:

    • Ask the customer to verify their card is not blocked or restricted by their bank.

    • Send a payment update email from the subscription admin portal in Loop.

    • If the error persists, ask the customer to contact their bank for more details or switch to an alternative payment method.
      ​

  6. Billing agreement cancelled: This error occurs when the subscription billing agreement has been cancelled or revoked by the customer or payment provider.
    ​

    Error messages: "CANCELLED_PAYMENT"
    ​

    Troubleshooting steps:

    • Verify the status of the billing agreement with the payment provider.

    • Send the customer a quick action URL to re-enable or renew the agreement, and consider offering an incentive to encourage them to update their payment method.
      ​

  7. Incorrect card number: This error occurs when the card number on file is not valid or does not match the issuer's records.
    ​

    Error messages: "CARD_NUMBER_INCORRECT," "INCORRECT_NUMBER," "INVALID_NUMBER"
    ​

    Troubleshooting steps:

    • Send a payment update email to the customer via the Loop subscription admin portal and ask them to re-enter their card details.

    • If the error persists, ask the customer to contact their bank to confirm the card number is correct and active.
      ​

  8. Invalid customer: This error occurs when the customer record could not be found or is no longer valid in Shopify.
    ​

    Error messages: "CUSTOMER_INVALID," "CUSTOMER_NOT_FOUND"
    ​

    Troubleshooting steps:

    • Check the customer's record in Shopify to confirm it exists and is active.

    • If the customer record has been deleted or merged, contact Shopify support for assistance in restoring or reassigning the subscription.
      ​

  9. Do not honor: This error occurs when the card issuer declines the transaction without providing a specific reason.
    ​

    Error messages: "DO_NOT_HONOR"
    ​

    Troubleshooting steps:

    • Ask the customer to contact their bank directly, as the issuer has flagged the transaction internally.

    • Send a payment update email from the Loop subscription admin portal and suggest the customer use an alternative payment method if the bank cannot resolve the issue.
      ​

  10. Some error occurred: This error indicates an unspecified issue occurred during payment processing.
    ​

    Error messages: "EXPIRED_BUYER_ACTION," "GENERIC_ERROR," "OFF_SESSION_REJECTED," "UNEXPECTED_ERROR"
    ​

    Troubleshooting steps:

    • Retry the payment from the subscription admin portal in Loop.

    • If the error persists, contact Shopify support to investigate the specific cause behind the error code.
      ​

  11. Card expired: This error occurs when the card or payment method on file has passed its expiration date.
    ​

    Error messages: "EXPIRED_CARD," "EXPIRED_PAYMENT_METHOD," "INVALID_EXPIRY_DATE"
    ​

    Troubleshooting steps:

    • Send a payment update email to the customer via the Loop subscription admin portal and ask them to add a new card.

    • Use quick action URLs to make it easy for the customer to update their payment details directly.
      ​

  12. Fraud suspected: This error occurs when the transaction is flagged as potentially fraudulent by the payment provider or a merchant rule.
    ​

    Error messages: "FRAUD_SUSPECTED," "MERCHANT_RULE," "CONTRACT_UNDER_REVIEW"
    ​

    Troubleshooting steps:

    • Ask the customer to contact their bank to confirm their identity and clear any fraud flags on their account.

    • If the issue is triggered by a merchant rule, review your fraud prevention settings in Shopify to confirm they are not blocking legitimate recurring transactions.

    • Suggest the customer use an alternative payment method while the issue is being investigated.
      ​

  13. Invalid gift card amount: This error occurs when a gift card is used for a transaction type that does not support it.
    ​

    Error messages: "FREE_GIFT_CARD_NOT_ALLOWED"
    ​

    Troubleshooting steps:

    • Inform the customer that gift cards cannot be used for recurring subscription payments.

    • Send a payment update email from the Loop subscription admin portal and ask the customer to add a supported payment method.
      ​

  14. Invalid address: This error occurs when the billing or shipping address on file does not match the issuer's records or is incomplete.
    ​

    Error messages: "INCORRECT_ADDRESS," "INCORRECT_ZIP," "INVALID_BILLING_ADDRESS," "INVALID_SHIPPING_ADDRESS"
    ​

    Troubleshooting steps:

    • Ask the customer to verify their billing and shipping address details match what is registered with their bank.

    • Send a payment update email from the Loop subscription admin portal so the customer can correct their address.
      ​

  15. Insufficient funds: This error occurs when the customer's account does not have enough funds to cover the transaction.
    ​

    Error messages: "INSUFFICIENT_FUNDS"
    ​

    Troubleshooting steps:

    • Offer discounts to subscription and configure retry payment settings in payment recovery in Loop app settings to automatically retry the charge when sufficient funds may be available.

    • Ask the customer to check their account balance and retry once sufficient funds are available, or switch to an alternative payment method.
      ​

  16. Insufficient inventory: This error occurs when the product does not have enough stock available to fulfill the subscription order.
    ​

    Error messages: "INSUFFICIENT_INVENTORY"
    ​

    Troubleshooting steps:

    • Check product inventory levels in Shopify and restock the product at an active location.

    • Once inventory is available, retry the order from the subscription admin portal in Loop.
      ​

  17. Invalid currency: This error occurs when the currency used for the transaction is not supported by the payment provider.
    ​

    Error messages: "INVALID_CURRENCY"
    ​

    Troubleshooting steps:

    • Confirm your payment provider supports the currency in which the subscription is billed.

    • Contact your payment provider to enable the required currency, or ask the customer to use a payment method that supports it.
      ​

  18. PayPal agreement invalid: This error occurs when the PayPal billing agreement on file is no longer valid or has expired.
    ​

    Error messages: "INVALID_CUSTOMER_BILLING_AGREEMENT"
    ​

    Troubleshooting steps:

    • If the customer is unable to renew the agreement, ask them to switch to an alternative payment method.
      ​

  19. Invalid payment method: This error occurs when the payment method on file is not valid or cannot be used for this transaction.
    ​

    Error messages: "INVALID_PAYMENT_METHOD"
    ​

    Troubleshooting steps:

    • Send a payment update email to the customer via the Loop subscription admin portal and ask them to add a valid payment method.

    • If the error persists, ask the customer to contact their bank or payment provider to confirm the method is active and supports recurring charges.
      ​

  20. Card type not supported: This error occurs when the card type or payment method is not supported for subscription purchases.
    ​

    Error messages: "INVALID_PURCHASE_TYPE," "PAYMENT_METHOD_UNSUPPORTED," "PURCHASE_TYPE_NOT_SUPPORTED"
    ​

    Troubleshooting steps:

    • Ask the customer to use a supported card type such as Visa, Mastercard, or American Express.

    • Confirm your payment gateway is configured to accept the customer's card type for recurring billing.
      ​

  21. No inventory location found: This error occurs when no active inventory location can be found, or the shipping address is not serviceable for the available locations.
    ​

    Error messages: "INVENTORY_ALLOCATIONS_NOT_FOUND"
    ​

    Troubleshooting steps:

    • Confirm the product is assigned to at least one enabled inventory location in Shopify.

    • Verify the customer's shipping address is serviceable for the available locations.

    • Once inventory and location issues are resolved, retry the payment from the subscription admin portal in Loop.
      ​

  22. Invoice already paid: This error occurs when the invoice for the order has already been paid and cannot be charged again.
    ​

    Error messages: "INVOICE_ALREADY_PAID"
    ​

    Troubleshooting steps:

    • Check the order history in Shopify to confirm the invoice has already been settled.

    • If the charge was triggered in error, contact Shopify support to investigate the duplicate billing attempt.
      ​

  23. Merchant account error: This error occurs when there is a configuration issue with the merchant's payment account.
    ​

    Error messages: "MERCHANT_ACCOUNT_ERROR"
    ​

    Troubleshooting steps:

    • Review your payment provider account settings to identify any configuration issues.

    • Contact your payment provider directly to resolve any account-level errors before retrying the payment.
      ​

  24. Gateway test mode error: This error occurs when the payment gateway is in test mode, or a test payment method was used in a live environment.
    ​

    Error messages: "NON_TEST_ORDER_LIMIT_REACHED," "PAYMENT_METHOD_INCOMPATIBLE_WITH_GATEWAY_CONFIG," "TEST_MODE"
    ​

    Troubleshooting steps:

    • Confirm your payment gateway is set to live mode in your Shopify payment settings.

    • Remove any test payment methods from active subscriptions and ask the customer to add a live payment method.
      ​

  25. Payment method revoked: This error occurs when the payment method has been removed or revoked and can no longer be charged.
    ​

    Error messages: "PAYMENT_METHOD_NOT_FOUND," "PAYMENT_METHOD_NOT_SPECIFIED"
    ​

    Troubleshooting steps:

    • Send the customer a quick action URL to add a new payment method.

    • If the method was revoked by the payment provider, ask the customer to contact their bank for clarification and switch to an alternative payment method.
      ​

  26. Payment provider error: This error occurs when a technical error arises on the payment provider's side during processing.
    ​

    Error messages: "PAYMENT_PROVIDER_ERROR," "PROCESSING_ERROR"
    ​

    Troubleshooting steps:

    • Retry the payment from the subscription admin portal in Loop after a short delay.

    • If the error persists, contact your payment provider to check for any ongoing technical issues on their end.
      ​

  27. Payment provider not enabled: This error occurs when the payment provider is not enabled on the store.
    ​

    Error messages: "PAYMENT_PROVIDER_IS_NOT_ENABLED"
    ​

    Troubleshooting steps:

    • Navigate to your Shopify payment settings and confirm the relevant payment provider is active.

    • If the provider has been disabled, re-enable it before retrying any failed subscription payments.
      ​

  28. PayPal general error: This error occurs when a general error arises during PayPal payment processing.
    ​

    Error messages: "PAYPAL_ERROR_GENERAL"


    ​Troubleshooting steps:

    • Ask the customer to log into their PayPal account and check for any alerts or required actions.

    • If the issue cannot be resolved within PayPal, send a payment update email from the Loop subscription admin portal and ask the customer to switch to an alternative payment method.
      ​

  29. Card retry declined: This error occurs when a retry attempt for a previously declined card is also declined by the issuer.
    ​

    Error messages: "RETRY_DECLINED"


    ​Troubleshooting steps:

    • Review your payment recovery retry settings in Loop to adjust the retry cadence.

    • Send a payment update email to the customer and ask them to switch to an alternative payment method, as continued retries on this card are unlikely to succeed.
      ​

  30. Transaction limit exceeded: This error occurs when the transaction amount exceeds the limit set by the payment provider or card issuer.
    ​

    Error messages: "TRANSACTION_LIMIT_EXCEEDED"
    ​

    Troubleshooting steps:

    • Ask the customer to contact their bank to raise their transaction limit.

    • If the limit cannot be raised, suggest the customer switch to a payment method with a higher transaction threshold.
      ​

  31. Transient error: This error indicates a temporary issue on the payment network that is usually resolved automatically.
    ​

    Error messages: "TRANSIENT_ERROR"


    ​Troubleshooting steps:

    • Retry the payment from the subscription admin portal in Loop after a short delay.

    • Configure retry payment settings in Loop to automatically reattempt transient failures.
      ​

  32. Shopify declined: This error occurs when Shopify declines the payment or does not receive confirmation from the payment processor.
    ​

    Error messages: "SHOPIFY_DECLINED," "SHOPIFY_NO_CONFIRMATION"


    ​Troubleshooting steps:

    • Retry the payment from the subscription admin portal in Loop.

    • If the error persists, contact Shopify support directly, as the decline originates from Shopify's end and Loop has no visibility into the specific cause.

Error codes on Loop before April 2026

The table below applies to payment errors before April 2026.

Error message category

Loop default texts

Description

card_declined

Your card was declined

The payment was rejected by the bank or card issuer, typically due to insufficient funds or security issues.

insufficient_funds

Your card has insufficient funds

The customer’s account does not have enough funds to complete the transaction.

card_expired

Your card has expired

The card used for the payment has passed its expiration date.

agreement_cancelled

Your billing agreement was canceled or revoked. Try using an alternative payment method.

The subscription billing agreement was canceled or revoked by the customer or provider.

card_not_supported

Your card is not accepted for payment. Try using an alternative payment method.

The payment method (e.g., card type) is not supported by the system or payment provider.

card_invalid

Your card is invalid

The card details entered are incorrect or the card itself is not valid.

paypal_error

Some error occurred. Please update the payment details on your PayPal account.

There’s an issue with PayPal’s processing or the customer’s PayPal account details need updating.

gateway_issue

Unable to process the payment. Contact the support team for help.

A technical issue occurred with the payment gateway or processing service.

payment_revoked

Payment method was revoked. Try using an alternative payment method.

The payment method was revoked by the payment processor, possibly due to fraud concerns or other reasons.

shoppay_not_enabled

Shop pay wallet is not enabled for payment. Try using an alternative payment method.

The Shop Pay wallet option is not activated or available for use.

not_confirmed_payments

Payment marked as failed due to non-confirmation

The payment failed because the customer did not confirm the payment details or authorization.

inventory_allocations_not_found

No inventory location found or enabled

The payment failed because the subscription product inventory is either unavailable or the shipping address is not serviceable.

Payment errors and troubleshooting steps

  1. Card declined: When a payment is declined, Shopify returns various error messages based on the specific issue, such as fraud suspicion or account restrictions.
    ​
    ​Error messages: These include "Your card was declined," "Processor Declined - Fraud Suspected," "Account restricted," and others indicating issues like repeated attempts, security violations, or invalid transactions.
    ​
    ​Troubleshooting steps:

    • Verify Card Status: Encourage the customer to check their card’s status. It could be expired, blocked, or restricted.

    • Alternate Payment Method: You can send a payment update email from the subscription admin portal via loop.

    • Contact Card Issuer: If the error persists, ask the customer to contact their bank or card issuer for more details about the decline.

  2. Insufficient funds: This error occurs when the customer's card or account lacks the necessary funds for the transaction.
    ​
    ​Error messages: "Your card has insufficient funds" or "2001 Insufficient Funds."
    ​
    ​Troubleshooting steps:

    • Configure retry payment settings in payment recovery in the loop app settings.

    • Advise the customer to check their balance, try a different payment method, or retry once sufficient funds are available.
      ​

  3. Card expired: This error occurs when the customer’s card is no longer valid due to its expiration date passing.
    ​
    ​Error messages: "Your card has expired," "Field: api_errors Error: credit_card_is_expired," or "2004 Expired Card."

    Troubleshooting steps: Send payment update email to the customer via the loop subscription admin portal & ask them to add a new card.
    ​

  4. Agreement cancelled: This error happens when the billing agreement between the customer and the payment provider has been cancelled or disabled.
    ​
    ​Error messages: "Agreement was canceled," "billing_agreement_disabled."

    Troubleshooting steps: Verify the status of the billing agreement with the payment provider and encourage the customer to re-enable or renew the agreement by sending quick action URLs and incentivizing them in case they update the payment method.
    ​

  5. Card not supported: This error occurs when the customer’s card type is not supported by the payment gateway.
    ​
    ​Error messages: "Your card does not support this type of purchase," "Credit card brand is not accepted for payment," "Your card is not supported. Please use a Visa, MasterCard, American Express, or JCB card."

    Troubleshooting steps: Suggest the customer use an accepted card type and ensure the payment gateway supports their card type.
    ​

  6. Card invalid: This error indicates issues with the card details entered by the customer.
    ​
    ​Error messages: "credit_card_not_found," "Your card number is incorrect," "2007 No Account," "Your card's expiration month is invalid," "CVV should have been present."

    Troubleshooting steps: Ask the customer to verify card details, expiration date, and billing address. If the error persists, suggest they contact their bank or card issuer.
    ​

  7. PayPal error: This error occurs when there’s an issue with the payment method in the customer’s PayPal account.
    ​
    ​Error messages: "Instruct the customer to retry the transaction using an alternative payment method from the customer's PayPal wallet."

    Troubleshooting steps: Suggest the customer try an alternative payment method within PayPal or use a different payment method.
    ​

  8. Gateway issues: These errors happen when there’s a problem with the payment gateway configuration.
    ​
    ​Error messages: "Payment provider is not enabled on the shop," "Le fournisseur de services de paiement n'est pas configuré sur la boutique."

    Troubleshooting steps: Make sure the payment provider is properly set up on your Shopify store, and confirm with the provider if there are any temporary system outages or issues.
    ​

  9. Payment revoked: This error occurs when the customer’s payment method is revoked by the payment provider.
    ​
    ​Error messages: "Payment method was revoked."

    Troubleshooting steps: Suggest the customer provide an alternative payment method and check with the payment provider to understand why the method was revoked.

  10. Shop Pay not enabled: This error occurs when the Shop Pay wallet is not enabled for payments on the store.
    ​
    ​Error messages: "Shop Pay wallet is not enabled for payment."

    Troubleshooting steps: Ensure Shop Pay is enabled in your Shopify payment settings, and if not, recommend the customer use a different payment method.
    ​

  11. Not confirmed payments: This error happens when the payment fails due to non-confirmation from the customer.
    ​
    ​Error messages: "Payment marked as failed due to non-confirmation."

    Troubleshooting steps: Ask the customer to confirm the payment and authorization steps, and verify that the payment method is authorized for recurring payments
    ​

  12. No inventory location found or enabled: This error occurs when the subscription payment fails because the product cannot be fulfilled due to unavailable inventory, unserviceable shipping address, or missing/disabled inventory location in Shopify.
    ​
    ​Error messages: "No Inventory Location Found or Enabled"
    ​
    ​Troubleshooting steps:

    • Check Product Inventory: Confirm that the product has sufficient stock available at an active inventory location.

    • Verify Location Settings: Ensure the product is assigned to at least one enabled location in Shopify.

    • Check Serviceability: Verify that the shipping address is serviceable for the available locations.

    • Retry Payment: Once inventory and location issues are resolved, retry the payment from the subscription admin portal in Loop.


​

Best practices to reduce payment failure

  1. Use quick action URLs & run campaigns to update payment methods & incentivize the subscribers.
    ​

  2. Use our smart payment recovery settings to retry failed payments. Get in touch with our support team in case of any confusion in configurations.
    ​

FAQs

The payment card is getting rejected for a subscription while the last order was placed without any issues.

There can be several reasons why a payment card gets rejected, even if it worked for a previous one-time purchase. The most common causes include:

  • Bank restrictions: The customer’s bank may have blocked the payment due to internal policies or fraud detection systems.

  • Customer actions: The customer may have manually blocked or canceled the card or transaction at their bank.

It's important to note that Shopify handles the actual payment processing, and Loop only receives the payment error code. Based on that, here are two common settings that can cause subscription payment failures:

  1. Cross-border payments: The customer's card must be enabled for international transactions if the payment is processed outside their home country.

  2. Recurring payments: The card must support and be enabled for recurring or automated charges, which are treated differently from one-time transactions.

Even if a card works for regular purchases, these two settings can prevent subscription payments from going through.


​Please contact Shopify to investigate any payment failures.

How do I investigate payment failure errors? My subscription payments are failing.

To clarify - Loop doesn't store or process the payments. This happens entirely in Shopify.

For every subscription re-bill:

  • Loop submits a billing attempt request to Shopify

  • Shopify requests the processor

  • Processor returns billing attempt status info back to Shopify

  • Loop subscribes to the Shopify webhook to get that info and processes the order(in case of success).

  • In case of a failed payment, they send the error message, which we display on the portal.

Please contact Shopify to investigate any payment failures.

Why can I not see the payment method for a subscription after clicking the Update payment button? Why does the update payment link sent from the Admin portal crash with an error?

When you set up a Payment provider, it is entirely done on Shopify. Once you create a subscription, Loop fetches the payment details from Shopify and looks for all available options. Loop in no way is allowed to control the Payment methods or errors that come with failures.

Loop (and every single app on the Shopify ecosystem) is only allowed to display the Payment details (like the last 4 characters) /Error Message by Shopify, which means complete control goes back to the Shopify team itself.

​

When you are generating the payment link, Loop makes an API call to Shopify, and the link is generated via the Shopify backend directly.

​

To conclude, we recommend that you reachout to Shopify and explain this issue to them.

Is the error "Your card was declined" considered a hard decline on your side? What acquirer/PSP errors are mapped to this? Is this a fraud-related error?

“Your card was declined” is a generic decline error returned by Shopify. By default, Loop does not automatically treat this as a hard decline, but you can configure it as one. You can view and manage hard decline behaviour here: Loop App > Retain > Payment Recovery > Hard Declines Behaviour

How is the error "Your payment method was revoked" different from the "Your card was declined"? Does the customer trigger this to stop accepting payments from a particular biller? Or is it an issuer decline?

Shopify may decide to map payment decline errors to multiple reasons, including:

  • Insufficient funds

  • Security checks

  • Fraud-related rules

Since the exact payment decline reason comes from Shopify/PSP, Shopify would be the best point of contact to identify the specific issuer or acquirer error behind this message.

The error "Payment method was revoked" is triggered when a customer actively revokes or removes authorisation for a payment method to be used for future charges. This is a customer-initiated action where they withdraw permission for a merchant to charge that payment method, particularly relevant for recurring payments or subscriptions. In Shopify Flow, there's even a specific trigger called "Customer payment method revoked" that fires when this happens.

"Card declined" is an issuer decline that happens at the point of transaction when the bank's automated systems reject the charge. This can occur for various reasons, such as insufficient funds, fraud detection, spending limits, or incorrect card details, even if the card worked previously.

So "payment method was revoked" is customer-initiated, meaning the customer is actively stopping you from charging that payment method. It's not an issuer decline, but rather the customer revoking their authorisation, which is especially important for subscription or recurring billing scenarios where you have stored payment credentials.

If Loop processes subscription payments, how is it that the initial payment was successful (for a recurring payment to be triggered) if the card number is incorrect?

The initial checkout payment is processed entirely by Shopify, not Loop. For recurring payments, Loop only asks Shopify to initiate the charge - Shopify proceeds further and shares the reason.

If this error appears during a recurring charge, it means Shopify/PSP is returning this response based on their internal validation.

To understand why the "incorrect card number" error is being returned after a successful initial payment, this would need to be investigated further by the Shopify Payments team.

Explore more FAQs

Need help?

No worries - we're here for you!

If you have any questions or need assistance, feel free to email us at [email protected] or chat with us using the support beacon at the bottom right of your screen.

Regards,

Loop Subscriptions Team 🙂

Related Articles
Recovery via retries
Expired/Voided payment status orders on Shopify
Change payment method
Payment migration
Did this answer your question?