52 known error codes for this model

account_closed Moderate

Customer bank account is closed and cannot be charged.

account_country_invalid_address Easy Fix

Business address country does not match account country requirements.

account_error_country_change_requires_additional_steps Moderate

Account country change requires additional support and migration steps.

account_invalid Easy Fix

Stripe-Account header references an invalid account ID.

account_number_invalid Easy Fix

Provided bank account number is invalid for the selected country.

acss_debit_session_incomplete Moderate

ACSS debit session is not yet ready for completion.

amount_too_large Moderate

Requested amount exceeds the maximum allowed by Stripe for this operation.

amount_too_small Moderate

Requested amount is below Stripe minimum threshold.

api_key_expired Easy Fix

Provided API key has expired and must be replaced.

authentication_required Moderate

Payment requires additional customer authentication to proceed.

balance_insufficient Moderate

Connected account balance is insufficient for transfer or payout.

balance_invalid_parameter Easy Fix

Invalid parameter supplied in balance object request.

bank_account_bad_routing_numbers Easy Fix

Bank routing details are invalid for this currency/account context.

bank_account_declined Moderate

Bank account cannot be charged or is unsupported.

bank_account_exists Moderate

Bank account already exists on the specified customer.

bank_account_restricted Moderate

Bank account has restrictions preventing requested payment flow.

bank_account_verification_failed Moderate

Bank account verification failed due to mismatch or retry exhaustion.

billing_invalid_mandate Moderate

Invoice/subscription attempted payment without valid active mandate.

capture_charge_authorization_expired Moderate

Charge authorization expired before capture attempt.

capture_unauthorized_payment Moderate

Charge is not authorized for capture.

card_decline_rate_limit_exceeded Moderate

Card has been declined too many times in a short period.

card_declined Moderate

Issuer declined the card transaction.

charge_already_captured Moderate

Charge has already been captured and cannot be captured again.

charge_already_refunded Moderate

Charge has already been fully refunded.

charge_disputed Moderate

Charge is currently disputed and normal refund flow is blocked.

charge_exceeds_source_limit Moderate

Charge exceeds rolling processing limit for this source type.

charge_exceeds_transaction_limit Moderate

Charge exceeds configured transaction limit for payment type.

resource_already_exists Moderate

A resource with the same custom identifier already exists.

resource_missing Easy Fix

Referenced Stripe resource ID is invalid or missing.

routing_number_invalid Easy Fix

Provided bank routing number is invalid.

secret_key_required Easy Fix

Operation requires a secret API key, not publishable key.

setup_attempt_failed Moderate

Latest SetupIntent attempt failed and requires a new payment method.

setup_intent_authentication_failure Moderate

Payment method authentication failed during setup intent.

setup_intent_invalid_parameter Easy Fix

Invalid parameter combination was sent for SetupIntent operation.

setup_intent_unexpected_state Moderate

SetupIntent state is incompatible with requested operation.

shipping_address_invalid Easy Fix

Shipping address data is insufficient/invalid for tax calculation.

shipping_calculation_failed Easy Fix

Shipping calculation failed due to unverified or invalid inputs.

status_transition_invalid Moderate

Requested status transition is invalid for current object state.

stripe_tax_inactive Easy Fix

Stripe Tax is not activated on this account.

tax_id_invalid Easy Fix

Provided tax identifier format is invalid.

tax_id_prohibited Easy Fix

Tax identifier cannot be supplied for this payment method.

taxes_calculation_failed Call a Pro

Stripe tax engine could not compute taxes for this order.

terminal_reader_busy Moderate

Terminal reader is busy processing another command.

terminal_reader_hardware_fault Call a Pro

Reader reported unrecoverable hardware fault and cannot accept payments.

terminal_reader_offline Moderate

Terminal reader is offline and unreachable.

terminal_reader_timeout Moderate

Command timed out while waiting for terminal reader response.

testmode_charges_only Easy Fix

Account is not fully activated and can only process test charges.

tls_version_unsupported Moderate

Integration is using unsupported TLS version; Stripe requires TLS 1.2+.

token_already_used Moderate

Single-use token was already consumed in a prior request.

token_in_use Moderate

Token is currently being used by a concurrent request.

transfers_not_allowed Easy Fix

Requested transfer is not permitted for this account state.

url_invalid Easy Fix

Provided URL does not meet Stripe endpoint format requirements.