The following table describes Stripe error codes. When an API error has a code value, its doc_url attribute contains a link to that error codes entry in the table.

Card decline errors

If a card issuer declines a charge and you get an API error, the error includes a decline_code that describes the reason. Stripe decline codes are more specific than card issuer decline codes.

Error code	Description

`account_closed`	The customers bank account has been closed.
`account_country_invalid_address`	The country of the business address provided doesnt match the country of the account. Businesses must be located in the same country as the account.
`account_error_country_change_requires_additional_steps`	Your account has already onboarded as a Connect platform. Changing your country requires additional steps. Contact Stripe support for more information.
`account_holder_name_verification_failed`	The account holder name provided doesnt match the name on file for the bank account. For Bacs Direct Debits, this can happen when Pay.UK payer name verification cant confirm the name for the provided sort code and account number.
`account_invalid`	The account ID provided as a value for the `Stripe-Account` header is invalid. Check that your requests are specifying a valid account ID.
`account_number_invalid`	The bank account number provided is invalid (for example, missing digits). Bank account information varies from country to country. We recommend creating validations in your entry forms based on the bank account formats we provide.
`acss_debit_session_incomplete`	The ACSS debit session isnt ready to transition to complete status yet. Try the request again later.
`action_blocked`	An approval rule on this account blocks this action. To allow it, modify or remove the rule in the Dashboard.
`alipay_upgrade_required`	This method for creating Alipay payments isnt supported anymore. Upgrade your integration to use Sources instead.
`amount_too_large`	The specified amount is greater than the maximum amount allowed. Use a lower amount and try again.
`amount_too_small`	The specified amount is less than the minimum amount allowed. Use a higher amount and try again.
`anomalous_money_movement_request`	This request was blocked because our anomaly detection system flagged it as anomalous. To retry the request, disable anomaly detection in your Dashboard settings by going to Settings > Developers > Manage API keys > Anomaly detection.
`api_key_expired`	The API key provided has expired. Obtain your current API keys from the Dashboard and update your integration to use them.
`authentication_required`	The payment requires authentication to proceed. If your customer is off session, notify your customer to return to your application and complete the payment. If you provided the error_on_requires_action parameter, then your customer should try another card that doesnt require authentication.
`authentication_failure`	The payment was declined because the payment method failed to pass authentication.
`balance_insufficient`	The transfer or payout couldnt be completed because the associated account doesnt have a sufficient balance available. Create a new transfer or payout using an amount less than or equal to the accounts available balance.
`balance_invalid_parameter`	Invalid parameter was provided in the balance method object. Check our API documentation or the returned error message for more context.
`bank_account_bad_routing_numbers`	The bank account is known to not support the currency in question.
`bank_account_declined`	The bank account provided cant be used to charge, either because it isnt verified yet or it isnt supported.
`bank_account_exists`	The bank account provided already exists on the specified Customer object. If the bank account should also be attached to a different customer, include the correct customer ID when making the request again.
`bank_account_restricted`	The customers account cant be used with the payment method.
`bank_account_verification_failed`	The bank account cant be verified, either because the microdeposit amounts provided dont match the actual amounts, or because verification has failed too many times.
`bank_account_unusable`	The bank account provided cant be used. A different bank account must be used.
`bank_account_unverified`	Your Connect platform is attempting to share an unverified bank account with a connected account.
`billing_invalid_mandate`	The Subscription or Invoice attempted payment on a PaymentMethod without an active mandate. To create Subscription or Invoice payments with this PaymentMethod, it must be confirmed on-session with a PaymentIntent or SetupIntent first.
`bitcoin_upgrade_required`	This method for creating Bitcoin payments isnt supported anymore. Upgrade your integration to use Sources instead.
`capability_not_active`	Your account is missing the active capabilities required to access this endpoint. Check the capabilities array in the error response for details, and complete the required steps before retrying.
`card_decline_rate_limit_exceeded`	This card has been declined too many times. You can try to charge this card again after 24 hours. We suggest reaching out to your customer to make sure theyve entered all of their information correctly and that there are no issues with their card.
`card_declined`	The card has been declined. When a card is declined, the error returned also includes the `decline_code` attribute with the reason why the card was declined. To learn more, see decline codes.
`cardholder_phone_number_required`	You must have a `phone_number` on file for Issuing Cardholders who will be creating EU cards. You cant create EU cards without a `phone_number` on file for the cardholder. See the 3DS Secure for more details.
`capture_charge_authorization_expired`	The charge cant be captured as the authorization has expired. Refer to the payment methods documentation to learn more.
`capture_unauthorized_payment`	The charge youre attempting to capture has not been authorized for capturing payment.
`charge_already_captured`	The charge youre attempting to capture has already been captured. Update the request with an uncaptured charge ID.
`charge_already_refunded`	The charge youre attempting to refund has already been refunded. Update the request to use the ID of a charge that has not been refunded.
`charge_disputed`	The charge youre attempting to refund has been charged back. See Disputes to learn how to respond to the dispute.
`charge_exceeds_source_limit`	This charge would cause you to exceed your rolling-window processing limit for this source type. Retry the charge later, or contact us to request a higher processing limit.
`charge_exceeds_transaction_limit`	This charge would cause you to exceed your processing limit for this payment type. Contact us to request a higher processing limit.
`charge_expired_for_capture`	The charge cant be captured because the authorization has expired. Authorization and capture charges must be captured within a set number of days (7 by default).
`charge_invalid_parameter`	One or more provided parameters wasnt allowed for the given operation on the Charge. See our API reference or the returned error message to see which values werent correct for that Charge.
`clearing_code_unsupported`	The clearing code provided isnt supported.
`country_code_invalid`	The country code provided was invalid.
`country_unsupported`	Your platform attempted to create a custom account in a country thats not yet supported. Make sure that users can only sign up in countries supported by custom accounts.
`coupon_expired`	The coupon provided for a subscription or order has expired. Either create a new coupon, or use an existing one thats valid.
`customer_max_payment_methods`	Youve reached the maximum number of PaymentMethods for this Customer. Either detach some PaymentMethods from this Customer or proceed with a different Customer.
`customer_max_subscriptions`	The maximum number of subscriptions for a customer has been reached. Contact us if youre receiving this error.
`customer_tax_location_invalid`	The customer address is missing or not valid for tax purposes. Provide a country as a two-letter ISO code and a postal_code, at minimum. See how to collect customer addresses.
`debit_not_authorized`	The customer has notified their bank that this payment was unauthorized.
`email_invalid`	The email address is invalid (for example, not properly formatted). Check that the email address is properly formatted and only includes allowed characters.
`expired_card`	The card has expired. Check the expiration date or use a different card.
`expired_payment_method`	The payment method expired. Check the expiration date or use a different payment method.
`financial_connections_account_inactive`	Data cant be refreshed on inactive Financial Connections accounts.
`financial_connections_no_successful_transaction_refresh`	Transaction data can only be retrieved for accounts that have at least one successful transaction refresh.
`forwarding_api_inactive`	The Vault and Forward API is currently not accessible with this account and configuration. Contact us if youre receiving this error.
`forwarding_api_invalid_parameter`	Invalid parameter was provided in the Vault and Forward API. Check our API documentation or the returned error message for more context.
`forwarding_api_retryable_upstream_error`	The destination endpoint appears to be offline or unresponsive, preventing Stripe from completing the request. Retry the request later.
`forwarding_api_upstream_connection_error`	Stripe didnt receive a response from the destination endpoint. This typically indicates a problem with the destination endpoint, rather than with Stripe.
`forwarding_api_upstream_connection_timeout`	The request to the destination endpoint timed out. This typically indicates a problem with the destination endpoint, rather than with Stripe.
`forwarding_api_upstream_error`	The destination endpoint appears to be offline or unresponsive, preventing Stripe from completing the request. You might want to investigate the state of the request on the third party because bytes might have been sent and the third-party state could be indeterminate.
`idempotency_key_in_use`	The idempotency key provided is currently being used in another request. This occurs if your integration is making duplicate requests simultaneously.
`incorrect_address`	The cards address is incorrect. Check the cards address or use a different card.
`incorrect_cvc`	The cards security code is incorrect. Check the cards security code or use a different card.
`incorrect_number`	The card number is incorrect. Check the cards number or use a different card.
`incorrect_postal_code`	The payment methods postal code is incorrect. Check the payment methods postal code or use a different payment method.
`incorrect_zip`	The cards postal code is incorrect. Check the cards postal code or use a different card.
`instant_payouts_config_disabled`	This connected account isnt eligible for Instant Payouts. Ask the platform to enable Instant Payouts.
`instant_payouts_limit_exceeded`	Youve reached your daily processing limits for Instant Payouts.
`instant_payouts_unsupported`	Instant Payouts arent available for this request. See Instant payouts for detailed requirements and supported configurations.
`insufficient_funds`	The customers account has insufficient funds to cover this payment.
`intent_invalid_state`	Intent isnt in the state thats required to perform the operation.
`intent_verification_method_missing`	Intent doesnt have verification method specified in its `PaymentMethodOptions` object.
`invalid_card_type`	The card provided as an external account isnt supported for payouts. Provide a non-prepaid debit card instead.
`invalid_characters`	This value provided to the field contains characters that are unsupported by the field.
`invalid_charge_amount`	The specified amount is invalid. The charge amount must be a positive integer in the smallest currency unit, and not exceed the minimum or maximum amount.
`invalid_cvc`	The cards security code is invalid. Check the cards security code or use a different card.
`invalid_expiry_month`	The cards expiration month is incorrect. Check the expiration date or use a different card.
`invalid_expiry_year`	The cards expiration year is incorrect. Check the expiration date or use a different card.
`invalid_mandate_reference_prefix_format`	The provided prefix used to generate the mandate reference is invalid.
`invalid_number`	The card number is invalid. Check the card details or use a different card.
`invalid_source_usage`	The source cant be used because it isnt in the correct state (for example, a charge request is trying to use a source with a `pending`, `failed`, or `consumed` status). Check the status of the source youre attempting to use.
`invalid_tax_location`	The specified location is invalid. Check the Supported address formats for the address formats supported when calculating tax.
`invoice_no_customer_line_items`	An invoice cant be generated for the specified customer as there are no pending invoice items. Verify that the correct customer is being specified or create any necessary invoice items first.
`invoice_no_payment_method_types`	An invoice cant be finalized because there are no payment method types available to process the payment. Your invoice template settings or the invoices payment_settings might be restricting which payment methods are available, or you might need to activate more payment methods in the Dashboard.
`invoice_no_subscription_line_items`	An invoice cant be generated for the specified subscription as there are no pending invoice items. Verify that the correct subscription is being specified or create any necessary invoice items first.
`invoice_not_editable`	The specified invoice can no longer be edited. Instead, consider creating additional invoice items that will be applied to the next invoice. You can either manually generate the next invoice or wait for it to be automatically generated at the end of the billing cycle.
`invoice_on_behalf_of_not_editable`	You cant update the `on_behalf_of` property of an invoice after the invoice has been assigned a number.
`invoice_payment_intent_requires_action`	This payment requires additional user action before it can be completed successfully. Payment can be completed using the PaymentIntent associated with the invoice.
`invoice_upcoming_none`	There is no upcoming invoice on the specified customer to preview. Only customers with active subscriptions or pending invoice items have invoices that can be previewed.
`livemode_mismatch`	Test and live mode API keys, requests, and objects are only available within the corresponding mode.
`lock_timeout`	This object cant 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. See the Object lock timeouts for more details.
`missing`	Both a customer and source ID have been provided, but the source hasnt been saved to the customer. To create a charge for a customer with a specified source, you must first save the card details.
`no_account`	The bank account couldnt be located.
`not_allowed_on_standard_account`	Transfers and payouts on behalf of a Standard connected account arent allowed.
`out_of_inventory`	One or more line items are out of stock. If more stock is available, update the inventorys orderable quantity and try again.
`parameter_invalid_empty`	One or more required values werent provided. Make sure requests include all required parameters.
`parameter_invalid_integer`	One or more of the parameters requires an integer, but the values provided were a different type. Make sure that only supported values are provided for each attribute. Refer to the API reference to see the type of data each attribute supports.
`parameter_invalid_string_blank`	One or more values provided only included whitespace. Check the values in your request and update any that contain only whitespace.
`parameter_invalid_string_empty`	One or more required string values is empty. Make sure that string values contain at least one character.
`parameter_missing`	One or more required values are missing. Check our API documentation to see which values are required to create or modify the specified resource.
`parameter_unknown`	The request contains one or more unexpected parameters. Remove these and try again.
`parameters_exclusive`	Two or more mutually exclusive parameters were provided. See the API reference or the returned error message to see which values are permitted when creating or modifying the specified resource.
`payment_intent_amount_reconfirmation_required`	You provided information that changed the total amount of your PaymentIntent. Show the updated amount to your customer and try again.
`payment_intent_action_required`	The provided payment method requires customer actions to complete, but `error_on_requires_action` was set. To add this payment method to your integration, we recommend that you first upgrade your integration to handle actions.
`payment_intent_authentication_failure`	The provided payment method has failed authentication. Provide a new payment method to attempt to fulfill this PaymentIntent again.
`payment_intent_automatic_tax_incomplete`	When `automatic_tax[enabled]=true`, you must provide enough location information to accurately determine tax rates for the customer to confirm the PaymentIntent and collect taxes.
`payment_intent_incompatible_payment_method`	The PaymentIntent expected a payment method with different properties than what was provided.
`payment_intent_invalid_parameter`	One or more provided parameters wasnt allowed for the given operation on the PaymentIntent. See the API reference or the returned error message to see which values werent correct for that PaymentIntent.
`payment_intent_konbini_rejected_confirmation_number`	The `confirmation_number` provided in `payment_method_options[konbini]` was rejected by the processing partner at time of PaymentIntent confirmation.
`payment_intent_mandate_invalid`	The provided mandate is invalid and cant be used for the payment intent.
`payment_intent_payment_attempt_expired`	The latest payment attempt for the PaymentIntent has expired. Check the last_payment_error property on the PaymentIntent for more details, and provide a new payment method to attempt to fulfill this PaymentIntent again.
`payment_intent_payment_attempt_failed`	The latest payment attempt for the PaymentIntent has failed. See the last_payment_error property on the PaymentIntent for more details, and provide a new payment method to attempt to fulfill this PaymentIntent again.
`payment_intent_unexpected_state`	The PaymentIntents state was incompatible with the operation you were trying to perform.
`payment_method_bank_account_already_verified`	This bank account has already been verified.
`payment_method_bank_account_blocked`	This bank account has failed verification in the past and cant be used. Contact us if you want to attempt to use these bank account credentials.
`payment_method_billing_details_address_missing`	The PaymentMethods billing details is missing address details. Update the missing fields and try again.
`payment_method_currency_mismatch`	The currency specified doesnt match the currency for the attached payment method. A payment can only be created for the same currency as the corresponding payment method.
`payment_method_customer_decline`	The customer didnt approve the payment. Provide a new payment method to attempt to fulfill this intent again.
`payment_method_invalid_parameter`	Invalid parameter was provided in the payment method object. See the API reference or the returned error message for more context.
`payment_method_invalid_parameter_testmode`	The parameter provided for payment method isnt allowed to be used in testmode. See the API reference or the returned error message for more context.
`payment_method_microdeposit_failed`	Microdeposits were failed to be deposited into the customers bank account. Check the account, institution, transit numbers, and currency type.
`payment_method_microdeposit_processing_error`	We cant send microdeposit transfers right now. Try again later.
`payment_method_microdeposit_verification_amounts_invalid`	You must provide exactly two microdeposit amounts.
`payment_method_microdeposit_verification_amounts_mismatch`	The amounts provided dont match the amounts that were sent to the bank account.
`payment_method_microdeposit_verification_attempts_exceeded`	Youve exceeded the number of allowed verification attempts.
`payment_method_microdeposit_verification_descriptor_code_mismatch`	The verification code provided doesnt match the one sent to the bank account.
`payment_method_microdeposit_verification_timeout`	Payment method should be verified with microdeposits within the required period.
`payment_method_not_available`	The payment processor for the provided payment method is temporarily unavailable. Try a different payment method or retry later with the same payment method.
`payment_method_provider_decline`	The payment or setup attempt was declined by the issuer or customer. Check the last_payment_error or last_setup_error property on the PaymentIntent or SetupIntent respectively for more details, and provide a new payment method to attempt to fulfill this intent again.
`payment_method_provider_timeout`	The payment method failed due to a timeout. Check the last_payment_error or last_setup_error property on the PaymentIntent or SetupIntent respectively for more details, and provide a new payment method to attempt to fulfill this intent again.
`payment_method_restricted`	The payment was declined because the payment method was restricted (for instance a card was reported lost or stolen).
`payment_method_unactivated`	The operation cant be performed because the payment method used hasnt been activated. Activate the payment method in the Dashboard, then try again.
`payment_method_unexpected_state`	The provided payment methods state was incompatible with the operation you were trying to perform. Confirm that the payment method is in an allowed state for the given operation before attempting to perform it.
`payment_method_unsupported_type`	The API only supports payment methods of certain types.
`payouts_limit_exceeded`	Youve reached your daily processing limits for this payout type.
`payouts_not_allowed`	Payouts have been disabled on the connected account. Check the connected accounts status to see if any additional information needs to be provided, or if payouts have been disabled for another reason.
`platform_account_required`	Only Stripe Connect platforms can work with other accounts. You can set up a Stripe Connect platform in the Dashboard.
`platform_api_key_expired`	The API key provided by your Connect platform has expired. This occurs if your platform has either generated a new key or the connected account has been disconnected from the platform. Obtain your current API keys from the Dashboard and update your integration, or contact the user and reconnect the account.
`postal_code_invalid`	The postal code provided was incorrect.
`processing_error`	An error occurred while processing the card. Try again later or with a different payment method.
`product_inactive`	The product this SKU belongs to is no longer available for purchase.
`progressive_onboarding_limit_exceeded`	Progressive onboarding limit has been reached for the platform.
`promotion_code_customer_missing_first_time`	A customer must be specified before applying a promotion code that is restricted to first-time transactions.
`promotion_code_customer_not_first_time`	This promotion code cant be redeemed because the associated customer has prior transactions. The promotion code is restricted to first-time customers only.
`rate_limit`	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.
`refer_to_customer`	The customer has stopped the payment with their bank. Contact them for details and to arrange payment.
`refund_disputed_payment`	You cant refund a disputed payment.
`resource_already_exists`	A resource with a user-specified ID (for example, plan or coupon) already exists. Use a different, unique value for `id` and try again.
`resource_missing`	The ID provided isnt valid. Either the resource doesnt exist, or an ID for a different resource has been provided.
`return_intent_already_processed`	You cant confirm this refund as its already processed.
`routing_number_invalid`	The bank routing number provided is invalid.
`secret_key_required`	The API key provided is a publishable key, but a secret key is required. Obtain your current API keys from the Dashboard and update your integration to use them.
`sepa_unsupported_account`	Your account doesnt support SEPA payments.
`setup_attempt_failed`	The latest setup attempt for the SetupIntent has failed. Check the `last_setup_error` property on the SetupIntent for more details, and provide a new payment method to attempt to set it up again.
`setup_intent_authentication_failure`	The provided payment method has failed authentication. Provide a new payment method to attempt to fulfill this SetupIntent again.
`setup_intent_invalid_parameter`	One or more provided parameters wasnt allowed for the given operation on the SetupIntent. See the API reference or the returned error message to see which values werent correct for that SetupIntent.
`setup_intent_mandate_invalid`	The provided mandate is invalid and cant be used for the setup intent.
`setup_intent_setup_attempt_expired`	The latest setup attempt for the SetupIntent has expired. Check the last_setup_error property on the SetupIntent for more details, and provide a new payment method to attempt to complete this SetupIntent again.
`setup_intent_unexpected_state`	The SetupIntents state was incompatible with the operation you were trying to perform.
`shipping_address_invalid`	The shipping address information cant be used to accurately determine tax rates. Verify that address fields such as zip code, state, or province have been added correctly.
`shipping_calculation_failed`	Shipping calculation failed because the information provided was either incorrect or couldnt be verified.
`sku_inactive`	The SKU is inactive and no longer available for purchase. Use a different SKU, or make the current SKU active again.
`state_unsupported`	Occurs when providing the `legal_entity` information for a U.S. custom account, if the provided state isnt supported. (This is mostly associated states and territories.)
`status_transition_invalid`	The requested status transition isnt valid.
`stripe_tax_inactive`	Stripe Tax hasnt been activated on your account. See the setup documentation to get started.
`tax_id_invalid`	The tax ID number provided is invalid (for example, missing digits). Tax ID information varies from country to country, but must be at least nine digits.
`tax_id_prohibited`	A tax identifier may not be provided on this payment method as it isnt required.
`taxes_calculation_failed`	Tax calculation for the order failed.
`terminal_location_country_unsupported`	Terminal is currently only available in some countries. Locations in your country cant be created in live mode.
`terminal_reader_busy`	Reader is currently busy processing another request. See the integration guide for details on how to handle this error.
`terminal_reader_hardware_fault`	Reader can no longer accept payments as an unrecoverable hardware fault has been detected. Contact Stripe support and provide your readers serial number for replacement.
`terminal_reader_invalid_location_for_activation`	Reader cant be activated in the currently registered Location. Register the reader to a new Location. See Manage locations for more information.
`terminal_reader_invalid_location_for_payment`	Reader cant take payments in the currently registered Location. Register the reader to a new Location. See Manage locations for more information.
`terminal_reader_offline`	Reader is currently offline. Ensure the reader is powered on and connected to the internet before retrying your request. See the integration guide for details on how to handle this error.
`terminal_reader_timeout`	There was a timeout when sending this command to the reader. See the integration guide for details on how to handle this error.
`testmode_charges_only`	You can only make test charges. Set up your account in the Dashboard to begin processing live charges.
`tls_version_unsupported`	Your integration is using an older version of TLS thats unsupported. You must be using TLS `1.2` or above.
`token_already_used`	The token provided has already been used. You must create a new token before you can retry this request.
`token_in_use`	The token provided is currently being used in another request. This occurs if your integration is making duplicate requests simultaneously.
`transfer_source_balance_parameters_mismatch`	When creating a Transfer, the `payments` parameter in `source_balance` shouldnt be passed in when balance `type` is set to `issuing`.
`transfers_not_allowed`	The requested transfer cant be created. Contact us if youre receiving this error.
`url_invalid`	The URL provided is invalid.

Was this page helpful?

Yes No

Need help? Contact Support.
Chat with Stripe developers on Discord.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc