# 错误代码 了解错误代码及解决方式。 Stripe 会记录您的集成创建的每个成功或失败的 API 请求。用 [Workbench](https://dashboard.stripe.com/workbench)检查错误并监控您的集成。 某些 [API 错误](https://docs.stripe.com/api/errors.md)包含 [code](https://docs.stripe.com/api/errors.md#errors-code) 属性，以帮助您[解决问题](https://docs.stripe.com/error-handling.md)。您也可以主动触发特定的[错误代码](https://docs.stripe.com/testing.md#declined-payments)用于测试。 下表描述了 Stripe 错误代码。当 API 错误具有 `code` 值，其 [doc_url](https://docs.stripe.com/api/errors.md#errors-doc_url) 属性包含指向该错误代码在表中对应条目的链接。 > #### 银行卡拒付错误 > > 如果发卡行拒绝收款且并返回 API 错误，该错误包含 [decline_code](https://docs.stripe.com/api/errors.md#errors-decline_code)，用于说明原因。Stripe 的[拒付代码](https://docs.stripe.com/declines/codes.md)比发卡行的拒付代码更为具体。 | 错误代码 | 描述 | | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `account_closed` | 客户的银行账户已被关闭。 | | `account_country_invalid_address` | 提供的商家地址所在的国家/地区与账户所在的国家/地区不匹配。商家必须与账户位于同一国家/地区。 | | `account_error_country_change_requires_additional_steps` | 您的账户已作为 Connect 平台入驻。更改国家/地区需要采取额外步骤。有关更多信息，请联系 Stripe 支持。 | | `account_holder_name_verification_failed` | 提供的账户持有人姓名与银行账户登记的名称不符。对于 Bacs 直接借记，当 Pay.UK 的付款人姓名验证无法根据所提供的分类代码 (sort code) 和账号确认姓名时，可能会出现这种情况。 | | `account_invalid` | 为 `Stripe-Account` 标头提供的账号 ID 值无效。请检查您的请求是否指定了有效的账户 ID。 | | `account_number_invalid` | 提供的银行账号无效（例如，位数不足）。银行账户信息因国家/地区而异。我们建议根据我们提供的[银行账户格式](https://docs.stripe.com/connect/payouts-bank-accounts.md)在您的分录表单中创建验证。 | | `acss_debit_session_incomplete` | ACSS 借记会话尚未准备好转换为完成状态。请稍后再次尝试该请求。 | | `alipay_upgrade_required` | 不再支持创建支付宝 (Alipay) 付款的方法，请升级您的集成系统，改用[支付源](https://docs.stripe.com/sources/alipay.md)。 | | `amount_too_large` | 指定的金额大于允许的最大金额。请使用较低的金额，然后重试。 | | `amount_too_small` | 指定的金额小于允许的最低金额。请使用较高的金额，然后重试。 | | `api_key_expired` | 提供的 API 密钥已过期。请从[管理平台](https://dashboard.stripe.com/apikeys)获取您当前的 API 密钥并更新您的集成来使用它们。 | | `authentication_required` | 该支付需要经过验证后才能继续。如果客户处于[会话外](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-off_session)，则通知客户返回到您的应用程序并完成支付。如果您提供了 [error_on_requires_action](https://docs.stripe.com/payments/without-card-authentication.md) 参数，则您的客户应尝试另一张不需要验证的卡。 | | `balance_insufficient` | 无法完成转账或提现，因为 Connect 子账户的可用余额不足。请使用小于或等于账户可用余额的金额创建新的转账或提现。 | | `balance_invalid_parameter` | balance method 对象中提供的参数无效。请查看我们的 API 文档或返回的错误消息以了解更多相关信息。 | | `bank_account_bad_routing_numbers` | 已知该银行账户不支持相关货币。 | | `bank_account_declined` | 提供的银行账户无法用于收款，因为尚未通过验证或尚不受支持。 | | `bank_account_exists` | 指定的 [Customer](https://docs.stripe.com/api.md#update_customer-source) 对象上已存在提供的银行账户。如果该银行账户还应关联到另一个客户，请在再次发出请求时提供正确的客户 ID。 | | `bank_account_restricted` | 客户的帐户无法使用该支付方式。 | | `bank_account_verification_failed` | 无法验证银行账户，可能是因为提供的微存款金额与实际金额不符，或是因为验证失败的次数过多。 | | `bank_account_unusable` | 提供的银行账户无法使用。必须使用一个不同的银行账户。 | | `bank_account_unverified` | 您的 Connect 平台正试图与某个 Connect 子账户共享一个未经验证的银行账户。 | | `billing_invalid_mandate` | Subscription 或 Invoice 尝试在不具备生效授权的情况下对 PaymentMethod 进行支付。要用此 PaymentMethod 创建 Subscription 或 Invoice 支付，必须先用 PaymentIntent 或 SetupIntent 进行会话内确认。 | | `bitcoin_upgrade_required` | 不再支持创建比特币付款的方法，请升级您的集成系统，改用[支付源](https://docs.stripe.com/sources.md)。 | | `card_decline_rate_limit_exceeded` | 该卡被拒绝的次数过多。您可以在 24 小时后再次尝试向该卡扣款。建议联系您的客户，确保他们已正确输入所有信息，并且他们的卡没有任何问题。 | | `card_declined` | 卡片被拒绝。当卡片被拒绝时，返回的错误信息还包括`decline_code`属性及卡片被拒原因。如需了解更多信息，请参阅[拒付代码](https://docs.stripe.com/declines/codes.md)。 | | `cardholder_phone_number_required` | 您必须对将创建欧盟银行卡的 Issuing 持卡人存档 `phone_number`。在没有持卡人的 `phone_number` 的情况下，您无法创建欧盟银行卡。请查看 [3DS 验证](https://docs.stripe.com/issuing/3d-secure.md)以了解更多详情。 | | `capture_charge_authorization_expired` | 授权已过期，无法扣款。如需更多信息，请参阅付款方式文档。 | | `capture_unauthorized_payment` | 您尝试扣款的交易尚未获得付款授权。 | | `charge_already_captured` | 您尝试扣款的交易已被扣款。请使用未扣款的交易 ID 更新请求。 | | `charge_already_refunded` | 您尝试[退款](https://docs.stripe.com/refunds.md)的收款已被退还。请更新请求，以使用尚未退款的收款的 ID。 | | `charge_disputed` | 您尝试[退款](https://docs.stripe.com/refunds.md)的扣款已被撤销。请查看[争议](https://docs.stripe.com/disputes.md)以了解如何回应争议。 | | `charge_exceeds_source_limit` | 这笔扣款将导致您超过此源类型的滚动窗口处理限额。请稍后重试扣款，或[联系我们](https://support.stripe.com/email)以申请提高处理限额。 | | `charge_exceeds_transaction_limit` | 这笔扣款将导致您超过该支付类型的处理限额。请[联系我们](https://support.stripe.com/contact/login)以请求提高处理限额。 | | `charge_expired_for_capture` | 授权已过期，无法扣款。授权和扣款必须在设定的天数（默认为 7 天）内完成。 | | `charge_invalid_parameter` | 一项或多项提供的参数不允许用于收款的指定操作。请参阅我们的 [API 参考文件](https://docs.stripe.com/api/charges.md)或返回的错误信息，以判断该收款的哪些值不正确。 | | `clearing_code_unsupported` | 不支持提供的清算代码。 | | `country_code_invalid` | 提供的国家/地区代码无效。 | | `country_unsupported` | 您的平台试图在尚不支持的国家/地区创建 Custom 账户。请确保用户只能在 [Custom 账户支持的国家/地区](https://docs.stripe.com/connect/custom-accounts.md#country)注册。 | | `coupon_expired` | 为[订阅](https://docs.stripe.com/api.md#subscriptions)或[订单](https://docs.stripe.com/api.md#orders)提供的[优惠券](https://docs.stripe.com/api.md#coupons)已过期。请要么创建新的优惠券，要么使用现有的有效优惠券。 | | `customer_max_payment_methods` | 您已达到此[客户](https://docs.stripe.com/api/customers.md)可持有的[ PaymentMethods ](https://docs.stripe.com/api/payment_methods.md)最大数量。请[解绑](https://docs.stripe.com/api/payment_methods/detach.md)部分支付方式，或更换其他客户继续操作。 | | `customer_max_subscriptions` | 已达到某个客户的最大订阅数。如果您收到此错误，请[联系我们](https://support.stripe.com/email)。 | | `customer_tax_location_invalid` | 客户地址缺失或不符合税务用途要求。至少需提供 [ country ](https://docs.stripe.com/api/customers/object.md#customer_object-address-country)（两位字母 [ ISO 代码 ](https://en.wikipedia.org/wiki/ISO_3166-1)）与 [ postal_code ](https://docs.stripe.com/api/customers/object.md#customer_object-address-postal_code)。参阅如何 [ 收集客户地址 ](https://docs.stripe.com/tax/customer-locations.md)。 | | `debit_not_authorized` | 客户通知其银行说该笔付款未授权。 | | `email_invalid` | 电子邮件地址无效（例如，格式不正确）。请检查电子邮件地址的格式是否正确，并且仅包含[允许的字符](https://en.wikipedia.org/wiki/Email_address#Local-part)。 | | `expired_card` | 卡片已过期，请核对过期日期或使用其他卡片。 | | `financial_connections_account_inactive` | 无法刷新不活动的 Financial Connections 账户上的数据。 | | `financial_connections_no_successful_transaction_refresh` | 只能为至少成功刷新过一次交易的账户检索交易数据。 | | `forwarding_api_inactive` | 此账户和配置目前无法访问 Vault and Forward API。如果您收到此错误，请[联系我们](https://support.stripe.com/contact)。 | | `forwarding_api_invalid_parameter` | Vault and Forward API 中提供的参数无效。请查看我们的 API 文档或返回的错误消息以了解更多相关信息。 | | `forwarding_api_retryable_upstream_error` | 目标端点似乎处于离线状态或没有响应，这导致 Stripe 无法完成请求。请稍后重试请求。 | | `forwarding_api_upstream_connection_error` | Stripe 未收到来自目标端点的响应。这通常表示目标端点有问题，而非 Stripe 有问题。 | | `forwarding_api_upstream_connection_timeout` | 向目标端点发送的请求发生超时。这通常表示目标端点有问题，而非 Stripe 有问题。 | | `forwarding_api_upstream_error` | 目标端点似乎处于离线状态或没有响应，这导致 Stripe 无法完成请求。您可能需要调查第三方请求状态，因为可能已发送字节数据且第三方状态可能不确定。 | | `idempotency_key_in_use` | 提供的幂等性密钥当前正被用于另一个请求。如果您的集成同时发出重复的请求，则会发生这种情况。 | | `incorrect_address` | 卡片地址不正确，请核对卡片地址或使用其他卡片。 | | `incorrect_cvc` | 卡片安全码不正确，请核对卡片安全码或使用其他卡片。 | | `incorrect_number` | 卡号不正确，请核对卡号或使用其他卡片。 | | `incorrect_zip` | 卡片邮政编码不正确，请核对卡片邮政编码或使用其他卡片。 | | `instant_payouts_config_disabled` | 此 Connect 子账户不符合 Instant Payouts 的条件。请要求平台启用 Instant Payouts。 | | `instant_payouts_limit_exceeded` | 您已达到 Instant Payouts 的每日处理限额。 | | `instant_payouts_unsupported` | Instant Payouts 不支持此请求。有关详细需求和支持配置，请参阅 [Instant Payouts](https://support.stripe.com/topics/instant-payouts)。 | | `insufficient_funds` | 客户的账户余额不足，无法完成这笔支付。 | | `intent_invalid_state` | Intent 未处于执行该操作所需的状态中。 | | `intent_verification_method_missing` | Intent 的 `PaymentMethodOptions` 对象中没有指定验证方式。 | | `invalid_card_type` | 作为[外部账户](https://stripe.com/api#external_accounts)提供的卡不支持提现。请改为提供一张非预付借记卡。 | | `invalid_characters` | 提供给字段的此值包含字段不支持的字符。 | | `invalid_charge_amount` | 指定金额无效。扣款金额必须为最小货币单位的正整数，且不得超出[最低或最高金额](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)。 | | `invalid_cvc` | 卡片安全码无效，请核对卡片安全码或使用其他卡片。 | | `invalid_expiry_month` | 卡片过期月份不正确，请核对过期日期或使用其他卡片。 | | `invalid_expiry_year` | 卡片过期年份不正确，请核对过期日期或使用其他卡片。 | | `invalid_mandate_reference_prefix_format` | 提供的用于生成授权编号的前缀无效。 | | `invalid_number` | 卡号无效，请核对卡片详细信息或使用其他卡片。 | | `invalid_source_usage` | 无法使用该支付源，因为其状态不正确（例如，扣款请求试图使用状态为`pending`、`failed`或`consumed`的支付源）。请核对您尝试使用的支付源的[状态](https://docs.stripe.com/api.md#source_object-status)。 | | `invalid_tax_location` | 指定位置无效。请查看[支持的地址格式](https://docs.stripe.com/tax/customer-locations.md#supported-formats)，了解计算税务时支持的地址格式。 | | `invoice_no_customer_line_items` | 无法为指定客户生成账单，因为没有待处理的账单明细项。请验证是否指定了正确的客户，或先创建必要的账单明细项。 | | `invoice_no_payment_method_types` | 无法最终确定账单，因为没有可用的支付方式来处理支付。您的[账单模板设置](https://dashboard.stripe.com/settings/billing/invoice)或账单的 [payment_settings](https://docs.stripe.com/api/invoices/object.md#invoice_object-payment_settings) 可能限制了可用的支付方式，或者您可能需要在管理平台中激活更多[支付方式](https://dashboard.stripe.com/settings/payments)。 | | `invoice_no_subscription_line_items` | 无法为指定的订阅生成账单，因为没有待处理的账单明细项。请验证是否指定了正确的订阅，或先创建必要的账单明细项。 | | `invoice_not_editable` | 无法再编辑指定的账单。相反，请考虑创建额外的[账单明细项](https://docs.stripe.com/billing/invoices/subscription.md#adding-upcoming-invoice-items)，将其应用到下一个账单。您可以[手动生成](https://docs.stripe.com/billing/invoices/subscription.md#generating-invoices)下一个账单，也可以等待在计费周期结束时自动生成下一个账单。 | | `invoice_on_behalf_of_not_editable` | 在为账单分配编号后，无法再更新账单的 `on_behalf_of` 属性。 | | `invoice_payment_intent_requires_action` | 此支付需要额外的用户操作执行后才能成功完成。可以使用与账单关联的 PaymentIntent 完成支付。 | | `invoice_upcoming_none` | 指定的客户没有即将到期的账单可供预览。只有具有有效订阅或待处理账单明细项的客户才有可预览的账单。 | | `livemode_mismatch` | 测试模式和实操模式的 API 密钥、请求和对象仅在相应模式下有效。 | | `lock_timeout` | 目前无法访问该对象，因为有另一个 API 请求或 Stripe 进程正在访问它。如果您只是偶尔看到该错误，请重试请求。如果您频繁看到该错误，并且正在同时对一个对象发出多个请求，请逐次发出请求或降低请求频率。请参阅[对象锁定超时](https://docs.stripe.com/rate-limits.md#object-lock-timeouts)以了解更多详情。 | | `missing` | 已提供客户和付款源 ID，但付款源尚未保存至客户账户中。要为有指定付款源的客户创建交易，须先保存银行卡详细信息。 | | `no_account` | 找不到该银行账户。 | | `not_allowed_on_standard_account` | 不允许代 Standard Connect 子账户进行转账和提现。 | | `out_of_inventory` | 一个或多个行项目缺货。如果还有库存，请更新库存的可订购数量并重试。 | | `parameter_invalid_empty` | 未提供一个或多个必需的值。请确保请求中包含所有必需的参数。 | | `parameter_invalid_integer` | 一个或多个参数需要整数，但提供的值具有不同类型。请确保为每个属性仅提供支持的值。请参考 [API 参考文件](https://docs.stripe.com/api.md)，查看各属性支持的数据类型。 | | `parameter_invalid_string_blank` | 提供的一个或多个值仅包含空白。请检查请求中的值并更新任何仅包含空白的值。 | | `parameter_invalid_string_empty` | 一个或多个必需的字符串值为空。请确保字符串值至少包含一个字符。 | | `parameter_missing` | 缺少一个或多个必需的值。请查看我们的 [API 文档](https://docs.stripe.com/api.md)，了解创建或修改指定资源时需要哪些值。 | | `parameter_unknown` | 该请求包含一个或多个意外参数。请删除这些参数并重试。 | | `parameters_exclusive` | 提供了两个或多个互斥参数。请参阅 [API 参考文件](https://docs.stripe.com/api.md)或返回的错误消息，查看在创建或修改指定资源时允许的值。 | | `payment_intent_amount_reconfirmation_required` | 您提供的信息改变了您的 PaymentIntent 的总金额。请向您的客户显示更新后的金额，然后重试。 | | `payment_intent_action_required` | 提供的支付方式需要客户操作才能完成，但设置了 `error_on_requires_action`。要将此支付方式添加到您的集成，我们建议您先[升级您的集成以处理操作](https://docs.stripe.com/payments/payment-intents/upgrade-to-handle-actions.md)。 | | `payment_intent_authentication_failure` | 提供的支付方式未通过身份验证。提供一个新的支付方式，再次尝试履行这个 PaymentIntent。 | | `payment_intent_automatic_tax_incomplete` | 当 `automatic_tax[enabled]=true` 时，您必须提供足够的位置信息才能准确确定税率，以便买家确认 PaymentIntent 并收取税款。 | | `payment_intent_incompatible_payment_method` | PaymentIntent 期望支付方式具有与提供的属性不同的属性。 | | `payment_intent_invalid_parameter` | 一项或多项提供的参数不允许用于 PaymentIntent 的指定操作。请参阅 [API 参考文件](https://docs.stripe.com/api/payment_intents.md)或返回的错误信息，以判断该 PaymentIntent 的哪些值不正确。 | | `payment_intent_konbini_rejected_confirmation_number` | `payment_method_options[konbini]` 中提供的`confirmation_number` 在 PaymentIntent 确认时被处理合作伙伴拒绝。 | | `payment_intent_mandate_invalid` | 提供的授权无效，无法用于支付意图。 | | `payment_intent_payment_attempt_expired` | 该 PaymentIntent 最近的支付尝试已过期。请检查 PaymentIntent 上的 [last_payment_error](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-last_payment_error) 属性以获取更多详细信息，并提供新的支付方式以再次尝试履行此 PaymentIntent。 | | `payment_intent_payment_attempt_failed` | 该 PaymentIntent 最近的支付尝试失败。请参阅 PaymentIntent 上的 [last_payment_error](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-last_payment_error) 属性以了解更多详细信息，并提供新的支付方式以再次尝试履行此 PaymentIntent。 | | `payment_intent_unexpected_state` | PaymentIntent 的状态与您尝试执行的操作不兼容。 | | `payment_method_bank_account_already_verified` | 该银行账户已通过验证。 | | `payment_method_bank_account_blocked` | 该银行账户在之前未通过验证，无法使用。如果您想尝试使用这些银行账户凭证，请[联系我们](https://support.stripe.com/email)。 | | `payment_method_billing_details_address_missing` | PaymentMethod 的账单详情中缺少地址详情。请更新缺少的字段，然后重试。 | | `payment_method_currency_mismatch` | 指定的货币与所关联的支付方式的货币不匹配。只能为与相应支付方式相同的货币创建支付。 | | `payment_method_customer_decline` | 客户未批准支付。请提供新的支付方式，再次尝试履行此 Intent。 | | `payment_method_invalid_parameter` | 支付方式对象中提供的参数无效。有关更多上下文，请参阅 [API 参考文件](https://docs.stripe.com/api.md)或返回的错误消息。 | | `payment_method_invalid_parameter_testmode` | 不允许在测试模式下使用为支付方式提供的参数。有关更多上下文，请参阅 [API 参考文件](https://docs.stripe.com/api.md)或返回的错误消息。 | | `payment_method_microdeposit_failed` | 微存款未能存入客户的银行账户。检查账户、机构、交易号码和货币类型。 | | `payment_method_microdeposit_verification_amounts_invalid` | 必须提供精确的两笔微存款金额。 | | `payment_method_microdeposit_verification_amounts_mismatch` | 提供的金额与发送到银行账户的金额不匹配。 | | `payment_method_microdeposit_verification_attempts_exceeded` | 您已超过允许的验证尝试次数。 | | `payment_method_microdeposit_verification_descriptor_code_mismatch` | 提供的验证码与发送到银行账户的验证码不匹配。 | | `payment_method_microdeposit_verification_timeout` | 应在规定期限内通过微存款验证支付方式。 | | `payment_method_not_available` | 所提供的支付方式的支付处理商暂时不可用。请尝试另一支付方式，或稍后使用同一支付方式重试。 | | `payment_method_provider_decline` | 支付或设置尝试被发卡行或客户拒绝。请分别检查 PaymentIntent 或 SetupIntent 上的 [last_payment_error](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-last_payment_error) 或 [last_setup_error](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-last_setup_error) 属性以了解更多详细信息，并提供新的支付方式以再次尝试履行此意图。 | | `payment_method_provider_timeout` | 支付方式因超时失败。请分别检查 PaymentIntent 或 SetupIntent 上的 [last_payment_error](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-last_payment_error) 或 [last_setup_error](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-last_setup_error) 属性以了解更多详细信息，并提供新的支付方式以再次尝试履行此意图。 | | `payment_method_unactivated` | 无法执行该操作，因为使用的支付方式尚未激活。在[管理平台](https://dashboard.stripe.com/account/payments/settings)中激活该支付方式，然后重试。 | | `payment_method_unexpected_state` | 提供的支付方式的状态与您尝试执行的操作不兼容。在尝试执行给定操作之前，请确认该支付方式处于给定操作的允许状态。 | | `payment_method_unsupported_type` | API 仅支持特定类型的支付方式。 | | `payouts_limit_exceeded` | 您已达到该提现类型的每日处理限额。 | | `payouts_not_allowed` | 已禁用 Connect 子账户的提现功能。请检查 Connect 子账户的状态，看是否需要提供任何[额外信息](https://docs.stripe.com/connect/identity-verification.md)，或者是否因[其他原因](https://docs.stripe.com/connect/handling-api-verification.md)而被禁用了提现功能。 | | `platform_account_required` | 只有 Stripe Connect 平台可以与其他账户结合使用。您可以在[管理平台](https://dashboard.stripe.com/account/applications/settings)中设置 Stripe Connect 平台。 | | `platform_api_key_expired` | 您的 Connect 平台提供的 API 密钥已过期。如果您的平台生成了新密钥，或者 Connect 子账户已与平台断开连接，就会发生这种情况。请从[管理平台](https://dashboard.stripe.com/account/apikeys)获取您当前的 API 密钥并更新您的集成，也可以联系用户并重新连接账户。 | | `postal_code_invalid` | 提供的邮编不正确。 | | `processing_error` | 处理卡片时发生错误，请稍后再试或使用其他支付方式。 | | `product_inactive` | 此库存单位所属产品已无法购买。 | | `progressive_onboarding_limit_exceeded` | 已达到平台的渐进式入驻限制。 | | `promotion_code_customer_missing_first_time` | 在应用仅限首次交易的优惠码前，必须先指定客户。 | | `promotion_code_customer_not_first_time` | 此优惠码无法兑换，因为关联客户已有历史交易记录。此优惠码仅限新客户使用。 | | `rate_limit` | API 的突发请求过多。建议对您的请求采取指数退避策略。 | | `refer_to_customer` | 该客户通过其银行停止了付款。联系他们了解具体信息并重新安排付款。 | | `refund_disputed_payment` | 您无法对有争议的支付进行退款。 | | `resource_already_exists` | 已存在具有用户指定的 ID 的资源（例如方案或优惠券）。请对 `id` 使用不同的唯一值，然后重试。 | | `resource_missing` | 提供的 ID 无效。资源不存在，或已提供其他资源的 ID。 | | `return_intent_already_processed` | 您无法确认这笔退款，因为它已被处理。 | | `routing_number_invalid` | 提供的银行路径号码无效。 | | `secret_key_required` | 提供的 API 密钥是公钥，但需要私钥。请从[管理平台](https://dashboard.stripe.com/account/apikeys)获取您当前的 API 密钥并更新您的集成来使用它们。 | | `sepa_unsupported_account` | 您的账户不支持[单一欧元支付区 (SEPA)](https://docs.stripe.com/sources/sepa-debit.md) 支付。 | | `setup_attempt_failed` | SetupIntent 最近的设置尝试失败。请检查 SetupIntent 上的 `last_setup_error` 属性以了解更多详情，并提供一个新的支付方式以再次尝试设置它。 | | `setup_intent_authentication_failure` | 提供的支付方式未通过验证。请提供新的支付方式以再次尝试履行此 SetupIntent。 | | `setup_intent_invalid_parameter` | 一项或多项提供的参数不允许用于 SetupIntent 的指定操作。请参阅 [API 参考文件](https://docs.stripe.com/api/setup_intents.md)或返回的错误信息，以判断该 SetupIntent 的哪些值不正确。 | | `setup_intent_mandate_invalid` | 提供的授权无效，无法用于设置意图。 | | `setup_intent_setup_attempt_expired` | 该 SetupIntent 最近的设置尝试已过期。请检查 SetupIntent 上的 [last_setup_error](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-last_setup_error) 属性以了解更多详细信息，并提供新的支付方式以再次尝试完成此 SetupIntent。 | | `setup_intent_unexpected_state` | SetupIntent 的状态与您尝试执行的操作不兼容。 | | `shipping_address_invalid` | 收货地址信息无法用来准确确定税率。请验证是否已正确添加地址字段，例如邮政编码、州或省。 | | `shipping_calculation_failed` | 由于提供的信息不正确或无法验证，运费计算失败。 | | `sku_inactive` | 该库存单位 (SKU) 已停用，无法购买。请使用其他库存单位，或重新激活当前库存单位。 | | `state_unsupported` | 如果提供的州不受支持，则在提供美国 Custom 账户的 `legal_entity` 信息时会发生此情况。（这发生在最相关的州和领地。） | | `status_transition_invalid` | 请求的状态转换无效。 | | `stripe_tax_inactive` | 您的账户尚未激活 Stripe Tax。请参阅[设置文档](https://docs.stripe.com/tax/set-up.md)以开始使用。 | | `tax_id_invalid` | 提供的税号无效（例如，位数不足）。税号信息因国家/地区而异，但必须至少为 9 位数。 | | `tax_id_prohibited` | 可能无法为该支付方式提供税务识别号，因为这不是必需的。 | | `taxes_calculation_failed` | 订单税务计算失败。 | | `terminal_location_country_unsupported` | 目前，Terminal 仅在少许国家/地区可用。在实时模式下无法创建您所在国家/地区的位置。 | | `terminal_reader_busy` | 读卡器目前正在处理另一请求。请查看[集成指南](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#handle-errors)，详细了解如何处理该错误。 | | `terminal_reader_hardware_fault` | 由于检测到不可修复的硬件故障，读卡器无法再接受支付。请联系 [Stripe 支持](https://support.stripe.com/contact/email)，并提供您的读卡器序列号以便更换。 | | `terminal_reader_invalid_location_for_activation` | 无法在当前注册的位置激活读卡器。请将读卡器注册到新位置。有关更多信息，请查看[管理位置](https://stripe.com/terminal/fleet/locations)。 | | `terminal_reader_invalid_location_for_payment` | 读卡器无法在当前注册的位置收款。请将读卡器注册到新位置。有关更多信息，请查看[管理位置](https://stripe.com/terminal/fleet/locations)。 | | `terminal_reader_offline` | 读卡器目前处于离线状态。请确保读卡器已通电且连接到 Internet，然后重试您的请求。请查看[集成指南](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#handle-errors)，详细了解如何处理该错误。 | | `terminal_reader_timeout` | 向读卡器发送此命令时发生超时。请查看[集成指南](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#handle-errors)，详细了解如何处理该错误。 | | `testmode_charges_only` | 您目前只能进行测试收款。[请在管理平台中设置您的账户](https://dashboard.stripe.com/account/onboarding)，以开始处理真实交易。 | | `tls_version_unsupported` | 您的集成使用的是不受支持的旧版 [TLS](https://docs.stripe.com/security.md)。您必须使用 TLS `1.2` 或更高版本。 | | `token_already_used` | 提供的令牌已被使用。您必须先创建一个新令牌，然后才能重试该请求。 | | `token_in_use` | 提供的令牌当前正被另一个请求使用。如果您的集成同时发出重复的请求，则会发生这种情况。 | | `transfer_source_balance_parameters_mismatch` | 创建转账时，当余额 `type` 设置为 `issuing` 时，不应传入 `source_balance` 中的 `payments` 参数。 | | `transfers_not_allowed` | 无法创建请求的转账。如果您收到此错误，请[联系我们](https://support.stripe.com/email)。 | | `url_invalid` | 提供的 URL 无效。 |