错误代码

了解错误代码及解决方式。

某些错误包含错误代码 - 一个具有简短解释的短字符串。这些代码可帮助您处理错误，例如支付错误。

以下是 Stripe 错误代码的列表、描述，偶尔还有一些有关如何解决错误代码的信息。每个 Error 对象都通过其 doc_url 属性与该列表关联。为进行测试，您还可以触发某些特定错误代码。

错误代码	描述

`account_closed`	客户的银行账户已被关闭。
`account_country_invalid_address`	提供的商家地址所在的国家/地区与账户所在的国家/地区不匹配。商家必须与账户位于同一国家/地区。
`account_invalid`	为 `Stripe-Account` 标头提供的账号 ID 值无效。请检查您的请求是否指定了有效的账户 ID。
`account_error_country_change_requires_additional_steps`	您的账户已作为 Connect 平台入驻。更改国家/地区需要采取额外步骤。有关更多信息，请联系 Stripe 支持。
`account_number_invalid`	提供的银行账号无效（例如，位数不足）。银行账户信息因国家/地区而异。我们建议根据我们提供的银行账户格式在您的分录表单中创建验证。
`amount_too_large`	指定的金额大于允许的最大金额。请使用较低的金额，然后重试。
`amount_too_small`	指定的金额小于允许的最低金额。请使用较高的金额，然后重试。
`api_key_expired`	提供的 API 密钥已过期。请从管理平台获取您当前的 API 密钥并更新您的集成来使用它们。
`authentication_required`	该支付需要经过验证后才能继续。如果客户处于会话外，则通知客户返回到您的应用程序并完成支付。如果您提供了 error_on_requires_action 参数，则您的客户应尝试另一张不需要验证的卡。
`balance_insufficient`	无法完成转账或提现，因为 Connect 子账户的可用余额不足。请使用小于或等于账户可用余额的金额创建新的转账或提现。
`balance_invalid_parameter`	balance method 对象中提供的参数无效。请查看我们的 API 文档或返回的错误消息以了解更多相关信息。
`bank_account_bad_routing_numbers`	已知该银行账户不支持相关货币。
`bank_account_declined`	提供的银行账户无法用于收款，因为尚未通过验证或尚不受支持。
`bank_account_exists`	指定的 Customer 对象上已存在提供的银行账户。如果该银行账户还应关联到另一个客户，请在再次发出请求时提供正确的客户 ID。
`bank_account_verification_failed`	无法验证银行账户，可能是因为提供的微存款金额与实际金额不符，或是因为验证失败的次数过多。
`bank_account_unusable`	提供的银行账户无法使用。必须使用一个不同的银行账户。
`bank_account_unverified`	您的 Connect 平台正试图与某个 Connect 子账户共享一个未经验证的银行账户。
`capture_charge_authorization_expired`	无法捕获这笔收款，因为授权已过期。请参考支付方式的文档以了解更多信息。
`capture_unauthorized_payment`	您尝试捕获的收款未获得捕获支付的授权。
`card_decline_rate_limit_exceeded`	该卡被拒绝的次数过多。您可以在 24 小时后再次尝试向该卡扣款。建议联系您的客户，确保他们已正确输入所有信息，并且他们的卡没有任何问题。
`charge_already_captured`	您尝试捕获的收款已被捕获。请用未捕获的收款 ID 更新请求。
`charge_already_refunded`	您尝试退款的收款已被退还。请更新请求，以使用尚未退款的收款的 ID。
`charge_disputed`	您尝试退款的扣款已被撤销。请查看争议以了解如何回应争议。
`charge_exceeds_source_limit`	这笔扣款将导致您超过此源类型的滚动窗口处理限额。请稍后重试扣款，或联系我们以申请提高处理限额。
`charge_exceeds_transaction_limit`	这笔扣款将导致您超过该支付类型的处理限额。请联系我们以请求提高处理限额。
`charge_invalid_parameter`	不允许使用提供的一个或多个参数对 Charge 进行特定操作。请查看我们的 API 参考文件或返回的错误消息，看哪些值不适合该 Charge。
`country_unsupported`	您的平台试图在尚不支持的国家/地区创建 Custom 账户。请确保用户只能在 Custom 账户支持的国家/地区注册。
`country_code_invalid`	提供的国家/地区代码无效。
`coupon_expired`	为订阅或订单提供的优惠券已过期。请要么创建新的优惠券，要么使用现有的有效优惠券。
`customer_max_subscriptions`	已达到某个客户的最大订阅数。如果您收到此错误，请联系我们。
`customer_max_payment_methods`	已达到此 Customer 的 PaymentMethods 的最大数目。请要么从该 Customer 分离一些 PaymentMethod，要么继续使用另一个 Customer。
`customer_tax_location_invalid`	缺少客户地址或不适用于税务目的。请确保至少提供一个国家/地区（形式为两个字母的 ISO 代码）和 postal_code。了解如何收集客户地址。
`shipping_address_invalid`	收货地址信息无法用来准确确定税率。请验证是否已正确添加地址字段，例如邮政编码、州或省。
`billing_invalid_mandate`	Subscription 或 Invoice 尝试在不具备生效授权的情况下对 PaymentMethod 进行支付。要用此 PaymentMethod 创建 Subscription 或 Invoice 支付，必须先用 PaymentIntent 或 SetupIntent 进行会话内确认。
`email_invalid`	电子邮件地址无效（例如，格式不正确）。请检查电子邮件地址的格式是否正确，并且仅包含允许的字符。
`idempotency_key_in_use`	提供的幂等性密钥当前正被用于另一个请求。如果您的集成同时发出重复的请求，则会发生这种情况。
`financial_connections_account_inactive`	无法刷新不活动的 Financial Connections 账户上的数据。
`financial_connections_no_successful_transaction_refresh`	只能为至少成功刷新过一次交易的账户检索交易数据。
`instant_payouts_unsupported`	该请求无法使用 Instant Payouts。请查看 Instant Payouts，了解具体要求和支持的配置。
`instant_payouts_limit_exceeded`	您已达到 Instant Payouts 的每日处理限额。
`instant_payouts_config_disabled`	此 Connect 子账户不符合 Instant Payouts 的条件。请要求平台启用 Instant Payouts。
`payouts_limit_exceeded`	您已达到该提现类型的每日处理限额。
`insufficient_funds`	客户的账户余额不足，无法完成这笔支付。
`invalid_characters`	提供给字段的此值包含字段不支持的字符。
`invalid_card_type`	作为外部账户提供的卡不支持提现。请改为提供一张非预付借记卡。
`invoice_no_customer_line_items`	无法为指定客户生成账单，因为没有待处理的账单明细项。请验证是否指定了正确的客户，或先创建必要的账单明细项。
`invoice_on_behalf_of_not_editable`	在为账单分配编号后，无法再更新账单的 `on_behalf_of` 属性。
`invoice_no_payment_method_types`	无法最终确定账单，因为没有可用的支付方式来处理支付。您的账单模板设置或账单的 payment_settings 可能限制了可用的支付方式，或者您可能需要在管理平台中激活更多支付方式。
`invoice_no_subscription_line_items`	无法为指定的订阅生成账单，因为没有待处理的账单明细项。请验证是否指定了正确的订阅，或先创建必要的账单明细项。
`invoice_not_editable`	无法再编辑指定的账单。相反，请考虑创建额外的账单明细项，将其应用到下一个账单。您可以手动生成下一个账单，也可以等待在计费周期结束时自动生成下一个账单。
`invoice_payment_intent_requires_action`	此支付需要额外的用户操作执行后才能成功完成。可以使用与账单关联的 PaymentIntent 完成支付。
`invoice_upcoming_none`	指定的客户没有即将到期的账单可供预览。只有具有有效订阅或待处理账单明细项的客户才有可预览的账单。
`no_account`	找不到该银行账户。
`debit_not_authorized`	客户通知其银行说该笔付款未授权。
`bank_account_restricted`	客户的帐户无法使用该支付方式。
`out_of_inventory`	一个或多个行项目处于缺货状态。如果有更多存货可用，请更新库存的可订购数量，然后重试。
`parameter_invalid_empty`	未提供一个或多个必需的值。请确保请求中包含所有必需的参数。
`parameter_invalid_integer`	一个或多个参数需要整数，但提供的值具有不同类型。请确保为每个属性仅提供支持的值。请参考 API 参考文件，查看各属性支持的数据类型。
`parameter_invalid_string_blank`	提供的一个或多个值仅包含空白。请检查请求中的值并更新任何仅包含空白的值。
`parameter_invalid_string_empty`	一个或多个必需的字符串值为空。请确保字符串值至少包含一个字符。
`parameter_missing`	缺少一个或多个必需的值。请查看我们的 API 文档，了解创建或修改指定资源时需要哪些值。
`parameter_unknown`	该请求包含一个或多个意外参数。请删除这些参数并重试。
`parameters_exclusive`	提供了两个或多个互斥参数。请参阅 API 参考文件或返回的错误消息，查看在创建或修改指定资源时允许的值。
`acss_debit_session_incomplete`	ACSS 借记会话尚未准备好转换为完成状态。请稍后再次尝试该请求。
`payment_method_billing_details_address_missing`	PaymentMethod 的账单详情中缺少地址详情。请更新缺少的字段，然后重试。
`payment_method_unsupported_type`	API 仅支持特定类型的支付方式。
`payment_method_customer_decline`	客户未批准支付。请提供新的支付方式，再次尝试履行此 Intent。
`payment_method_microdeposit_verification_attempts_exceeded`	您已超过允许的验证尝试次数。
`intent_invalid_state`	Intent 未处于执行该操作所需的状态中。
`intent_verification_method_missing`	Intent 的 `PaymentMethodOptions` 对象中没有指定验证方式。
`payment_method_invalid_parameter`	支付方式对象中提供的参数无效。有关更多上下文，请参阅 API 参考文件或返回的错误消息。
`payment_method_invalid_parameter_testmode`	不允许在测试模式下使用为支付方式提供的参数。有关更多上下文，请参阅 API 参考文件或返回的错误消息。
`payment_method_provider_timeout`	支付方式因超时失败。请分别检查 PaymentIntent 或 SetupIntent 上的 last_payment_error 或 last_setup_error 属性以了解更多详细信息，并提供新的支付方式以再次尝试履行此意图。
`payment_method_provider_decline`	支付或设置尝试被发卡行或客户拒绝。请分别检查 PaymentIntent 或 SetupIntent 上的 last_payment_error 或 last_setup_error 属性以了解更多详细信息，并提供新的支付方式以再次尝试履行此意图。
`payment_method_microdeposit_verification_amounts_mismatch`	提供的金额与发送到银行账户的金额不匹配。
`payment_method_microdeposit_verification_descriptor_code_mismatch`	提供的验证码与发送到银行账户的验证码不匹配。
`payment_method_microdeposit_verification_amounts_invalid`	必须提供精确的两笔微存款金额。
`payment_method_microdeposit_failed`	微存款未能存入客户的银行账户。检查账户、机构、交易号码和货币类型。
`payment_method_microdeposit_verification_timeout`	应在规定期限内通过微存款验证支付方式。
`payment_method_bank_account_already_verified`	该银行账户已通过验证。
`payment_method_bank_account_blocked`	该银行账户在之前未通过验证，无法使用。如果您想尝试使用这些银行账户凭证，请联系我们。
`payment_method_unactivated`	无法执行该操作，因为使用的支付方式尚未激活。在管理平台中激活该支付方式，然后重试。
`payment_method_currency_mismatch`	指定的货币与所关联的支付方式的货币不匹配。只能为与相应支付方式相同的货币创建支付。
`payment_method_unexpected_state`	提供的支付方式的状态与您尝试执行的操作不兼容。在尝试执行给定操作之前，请确认该支付方式处于给定操作的允许状态。
`payment_method_not_available`	所提供的支付方式的支付处理商暂时不可用。请尝试另一支付方式，或稍后使用同一支付方式重试。
`payment_intent_unexpected_state`	PaymentIntent 的状态与您尝试执行的操作不兼容。
`payment_intent_incompatible_payment_method`	PaymentIntent 期望支付方式具有与提供的属性不同的属性。
`payment_intent_invalid_parameter`	提供的一个或多个参数不允许用于 PaymentIntent 上的给定操作。请查看 API 参考文件或返回的错误消息，看哪些值不适合该 PaymentIntent。
`payment_intent_mandate_invalid`	提供的授权无效，无法用于支付意图。
`setup_intent_mandate_invalid`	提供的授权无效，无法用于设置意图。
`invalid_mandate_reference_prefix_format`	提供的用于生成授权编号的前缀无效。
`payment_intent_konbini_rejected_confirmation_number`	`payment_method_options[konbini]` 中提供的`confirmation_number` 在 PaymentIntent 确认时被处理合作伙伴拒绝。
`payment_intent_authentication_failure`	提供的支付方式未通过身份验证。提供一个新的支付方式，再次尝试履行这个 PaymentIntent。
`payment_intent_payment_attempt_failed`	该 PaymentIntent 最近的支付尝试失败。请参阅 PaymentIntent 上的 last_payment_error 属性以了解更多详细信息，并提供新的支付方式以再次尝试履行此 PaymentIntent。
`payment_intent_payment_attempt_expired`	该 PaymentIntent 最近的支付尝试已过期。请检查 PaymentIntent 上的 last_payment_error 属性以获取更多详细信息，并提供新的支付方式以再次尝试履行此 PaymentIntent。
`setup_intent_setup_attempt_expired`	该 SetupIntent 最近的设置尝试已过期。请检查 SetupIntent 上的 last_setup_error 属性以了解更多详细信息，并提供新的支付方式以再次尝试完成此 SetupIntent。
`payment_intent_amount_reconfirmation_required`	您提供的信息改变了您的 PaymentIntent 的总金额。请向您的客户显示更新后的金额，然后重试。
`payment_intent_automatic_tax_incomplete`	当 `automatic_tax[enabled]=true` 时，您必须提供足够的位置信息才能准确确定税率，以便买家确认 PaymentIntent 并收取税款。
`payment_intent_action_required`	提供的支付方式需要客户操作才能完成，但设置了 `error_on_requires_action`。要将此支付方式添加到您的集成，我们建议您先升级您的集成以处理操作。
`platform_account_required`	只有 Stripe Connect 平台可以与其他账户结合使用。您可以在管理平台中设置 Stripe Connect 平台。
`setup_intent_authentication_failure`	提供的支付方式未通过验证。请提供新的支付方式以再次尝试履行此 SetupIntent。
`setup_intent_unexpected_state`	SetupIntent 的状态与您尝试执行的操作不兼容。
`setup_intent_invalid_parameter`	提供的一个或多个参数不允许用于 SetupIntent 上的给定操作。请查看 API 参考文件或返回的错误消息，看哪些值不适合该 SetupIntent。
`setup_attempt_failed`	SetupIntent 最近的设置尝试失败。请检查 SetupIntent 上的 `last_setup_error` 属性以了解更多详情，并提供一个新的支付方式以再次尝试设置它。
`status_transition_invalid`	请求的状态转换无效。
`payouts_not_allowed`	已禁用 Connect 子账户的提现功能。请检查 Connect 子账户的状态，看是否需要提供任何额外信息，或者是否因其他原因而被禁用了提现功能。
`platform_api_key_expired`	您的 Connect 平台提供的 API 密钥已过期。如果您的平台生成了新密钥，或者 Connect 子账户已与平台断开连接，就会发生这种情况。请从管理平台获取您当前的 API 密钥并更新您的集成，也可以联系用户并重新连接账户。
`postal_code_invalid`	提供的邮编不正确。
`refer_to_customer`	该客户通过其银行停止了付款。联系他们了解具体信息并重新安排付款。
`resource_already_exists`	已存在具有用户指定的 ID 的资源（例如方案或优惠券）。请对 `id` 使用不同的唯一值，然后重试。
`resource_missing`	提供的 ID 无效。资源不存在，或已提供其他资源的 ID。
`routing_number_invalid`	提供的银行路径号码无效。
`stripe_tax_inactive`	您的账户尚未激活 Stripe Tax。请参阅设置文档以开始使用。
`clearing_code_unsupported`	不支持提供的清算代码。
`secret_key_required`	提供的 API 密钥是公钥，但需要私钥。请从管理平台获取您当前的 API 密钥并更新您的集成来使用它们。
`state_unsupported`	如果提供的州不受支持，则在提供美国 Custom 账户的 `legal_entity` 信息时会发生此情况。（这发生在最相关的州和领地。）
`tax_id_invalid`	提供的税号无效（例如，位数不足）。税号信息因国家/地区而异，但必须至少为 9 位数。
`tax_id_prohibited`	可能无法为该支付方式提供税务识别号，因为这不是必需的。
`terminal_location_country_unsupported`	目前，Terminal 仅在少许国家/地区可用。在实时模式下无法创建您所在国家/地区的位置。
`terminal_reader_offline`	读卡器目前处于离线状态。请确保读卡器已通电且连接到 Internet，然后重试您的请求。请查看集成指南，详细了解如何处理该错误。
`terminal_reader_timeout`	向读卡器发送此命令时发生超时。请查看集成指南，详细了解如何处理该错误。
`terminal_reader_busy`	读卡器目前正在处理另一请求。请查看集成指南，详细了解如何处理该错误。
`terminal_reader_hardware_fault`	由于检测到不可修复的硬件故障，读卡器无法再接受支付。请联系 Stripe 支持，并提供您的读卡器序列号以便更换。
`terminal_reader_invalid_location_for_activation`	无法在当前注册的位置激活读卡器。请将读卡器注册到新位置。有关更多信息，请查看管理位置。
`terminal_reader_invalid_location_for_payment`	读卡器无法在当前注册的位置收款。请将读卡器注册到新位置。有关更多信息，请查看管理位置。
`tls_version_unsupported`	您的集成使用的是不受支持的旧版 TLS。您必须使用 TLS `1.2` 或更高版本。
`token_already_used`	提供的令牌已被使用。您必须先创建一个新令牌，然后才能重试该请求。
`token_in_use`	提供的令牌当前正被另一个请求使用。如果您的集成同时发出重复的请求，则会发生这种情况。
`transfers_not_allowed`	无法创建请求的转账。如果您收到此错误，请联系我们。
`transfer_source_balance_parameters_mismatch`	创建转账时，当余额 `type` 设置为 `issuing` 时，不应传入 `source_balance` 中的 `payments` 参数。
`url_invalid`	提供的 URL 无效。
`not_allowed_on_standard_account`	不允许代 Standard Connect 子账户进行转账和提现。
`lock_timeout`	目前无法访问该对象，因为有另一个 API 请求或 Stripe 进程正在访问它。如果您只是偶尔看到该错误，请重试请求。如果您频繁看到该错误，并且正在同时对一个对象发出多个请求，请逐次发出请求或降低请求频率。请参阅对象锁定超时以了解更多详情。
`cardholder_phone_number_required`	您必须对将创建欧盟银行卡的 Issuing 持卡人存档 `phone_number`。在没有持卡人的 `phone_number` 的情况下，您无法创建欧盟银行卡。请查看 3DS 验证以了解更多详情。
`return_intent_already_processed`	您无法确认这笔退款，因为它已被处理。
`refund_disputed_payment`	您无法对有争议的支付进行退款。
`progressive_onboarding_limit_exceeded`	已达到平台的渐进式入驻限制。
`forwarding_api_inactive`	此账户和配置目前无法访问 Vault and Forward API。如果您收到此错误，请联系我们。
`forwarding_api_invalid_parameter`	Vault and Forward API 中提供的参数无效。请查看我们的 API 文档或返回的错误消息以了解更多相关信息。
`forwarding_api_upstream_connection_timeout`	向目标端点发送的请求发生超时。这通常表示目标端点有问题，而非 Stripe 有问题。
`forwarding_api_upstream_connection_error`	Stripe 未收到来自目标端点的响应。这通常表示目标端点有问题，而非 Stripe 有问题。
`forwarding_api_retryable_upstream_error`	目标端点似乎处于离线状态或没有响应，这导致 Stripe 无法完成请求。请稍后重试请求。
`forwarding_api_upstream_error`	目标端点似乎处于离线状态或没有响应，这导致 Stripe 无法完成请求。您可能需要调查第三方请求状态，因为可能已发送字节数据且第三方状态可能不确定。
`alipay_upgrade_required`	This method for creating Alipay payments isn’t supported anymore. Upgrade your integration to use Sources instead.
`bitcoin_upgrade_required`	This method for creating Bitcoin payments isn’t supported anymore. Upgrade your integration to use Sources instead.
`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.
`charge_expired_for_capture`	The charge can’t be captured because the authorization has expired. Authorization and capture charges must be captured within a set number of days (7 by default).
`expired_card`	The card has expired. Check the expiration date or use a different card.
`incorrect_address`	The card’s address is incorrect. Check the card’s address or use a different card.
`incorrect_cvc`	The card’s security code is incorrect. Check the card’s security code or use a different card.
`incorrect_number`	The card number is incorrect. Check the card’s number or use a different card.
`incorrect_zip`	The card’s postal code is incorrect. Check the card’s postal code or use a different card.
`invalid_tax_location`	The specified location is invalid. Check the Supported address formats for the address formats supported when calculating tax.
`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 card’s security code is invalid. Check the card’s security code or use a different card.
`invalid_expiry_month`	The card’s expiration month is incorrect. Check the expiration date or use a different card.
`invalid_expiry_year`	The card’s expiration year is incorrect. Check the expiration date or use a different card.
`invalid_number`	The card number is invalid. Check the card details or use a different card.
`invalid_source_usage`	The source can’t be used because it isn’t 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 you’re attempting to use.
`livemode_mismatch`	Test and live mode API keys, requests, and objects are only available within the corresponding mode.
`missing`	Both a customer and source ID have been provided, but the source hasn’t been saved to the customer. To create a charge for a customer with a specified source, you must first save the card details.
`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.
`rate_limit`	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.
`sepa_unsupported_account`	Your account doesn’t support SEPA payments.
`shipping_calculation_failed`	Shipping calculation failed because the information provided was either incorrect or couldn’t 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.
`taxes_calculation_failed`	Tax calculation for the order failed.
`testmode_charges_only`	Your account hasn’t been activated and can only make test charges. Activate your account in the Dashboard to begin processing live charges.