# Stripe 拒绝代码

了解 Stripe 拒绝代码及支付失败时的解决方案。

Stripe 使用自己的拒绝代码，涵盖许多与[发卡行拒绝代码](https://docs.stripe.com/declines/network-codes.md)相同的潜在原因。Stripe 的拒绝代码对发卡行拒绝代码进行了进一步细化，更具体地说明了拒绝的原因。除了拒绝代码外，错误还可包含 [advice_code](https://docs.stripe.com/declines/card.md#retrying-issuer-declines)，并附上建议的后续操作步骤。

> #### 其他 API 错误
> 
> 某些 [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)。

## 银行卡拒付代码

这些是用于银行卡支付的 Stripe 拒付代码：

| 拒付代码 | 描述 | 后续步骤 |
| --- | --- | --- |
| `authentication_required` | 该卡被拒绝，原因是交易需要身份验证，例如 *3DS 验证* (3D Secure (3DS) provides an additional layer of authentication for credit card transactions that protects businesses from liability for fraudulent card payments)。 | 使用 Stripe 的前端时，在大多数情况下，发卡行的软拒绝会触发身份验证流程，允许客户重试并对其银行卡进行身份验证。在某些情况下，例如*非会话支付* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information)，您可能需要要求客户重试。如果尽管交易成功通过了身份验证，发卡行仍然返回此[拒绝代码](https://support.stripe.com/questions/authenticated-payment-declined-with-an-authentication-required-decline-code)，客户需要联系其发卡行了解更多信息。 |
| `authentication_not_handled` | 与 `authentication_required` 相关。客户试图在未执行所需身份验证的情况下继续操作，因此发卡行再次拒绝。 | 运行 EMV 3DS 验证或强客户认证 (SCA) 流程。对于离线支付，请先收集并准备在线身份验证，然后在需要时回退到在线验证。 |
| `approve_with_id` | 该笔付款未被授权。 | 再次尝试付款。如仍无法处理，则客户需要联系其发卡行。 |
| `call_issuer` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| `card_not_supported` | 银行卡不支持此类消费。 | 客户需要联系其发卡行，确保他们的卡可用于这种购物类型。 |
| `card_velocity_exceeded` | 客户超出了其银行卡的余额、信用额度或可用的交易限额。 | 客户需要联系发卡行来了解更多信息。 |
| `currency_not_supported` | 银行卡不支持指定的货币。 | 客户需要与其发卡行核对，问清楚该卡是否可用于指定的货币类型。 |
| `do_not_honor` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| (已弃用)`do_not_try_again` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| `duplicate_transaction` | 最近提交了一笔金额和银行卡信息完全相同的交易。 | 检查是否已存在一笔近期的付款。 |
| `expired_card` | 该卡已过期。 | 客户需要换用另外一张卡。 |
| `fraudulent` | 该笔付款被拒绝了，原因是 Stripe 怀疑为欺诈。 | 不要向您的客户报告更详细的信息。请按与 `generic_decline` 相同的方式显示。 |
| `generic_decline` | 银行卡因未知原因被拒绝，或被 Stripe Radar 或 Adaptive Acceptance [阻止支付](https://docs.stripe.com/declines.md#blocked-payments)。 | 客户需要联系发卡行来了解更多信息。 |
| `incorrect_address` | 客户输入的地址有误。 | 客户需使用正确地址重新尝试操作。 |
| `incorrect_cvc` | CVC 号不正确。 | 客户需要使用正确的 CVC 重试。 |
| `incorrect_number` | 卡号不正确。 | 客户需要使用正确的卡号重试。 |
| `incorrect_pin` | 输入的 PIN 不正确。该拒付代码仅适用于通过读卡器进行的付款。 | 客户需要使用正确的 PIN 重试。 |
| `incorrect_zip` | 邮编不正确。 | 客户需要使用正确的开单地址邮编重试。 |
| `insufficient_funds` | 该卡资金不足，不能完成购买。 | 客户需要使用另一支付方式。 |
| `invalid_account` | 该卡或它关联的账户无效。 | 客户需要联系其发卡行，核对该卡是否可正常使用。 |
| `invalid_amount` | 付款金额无效，或超过了允许的金额。 | 如果金额看上去是正确的，则客户需要与其发卡行核对，看是否可以消费此金额。 |
| `invalid_cvc` | CVC 号不正确。 | 客户需要使用正确的 CVC 重试。 |
| `invalid_expiry_month` | 到期月份无效。 | 客户需要使用正确的有效期重试。 |
| `invalid_expiry_year` | 到期年份无效。 | 客户需要使用正确的有效期重试。 |
| `invalid_number` | 卡号不正确。 | 客户需要使用正确的卡号重试。 |
| `invalid_pin` | 输入的 PIN 不正确。 | 客户需要使用正确的 PIN 重试。 |
| `issuer_not_available` | 无法联系到发卡行，因此未能授权这笔付款。 | 再次尝试付款。如仍无法处理，则客户需要联系其发卡行。 |
| `lost_card` | 该笔付款被拒绝了，原因是该卡已被挂失。 | 不应向客户报告拒绝的具体原因。请改以 `generic_decline` 的方式呈现。 |
| `merchant_blacklist` | 该笔付款被拒绝了，原因是它匹配上了 Stripe 的用户阻止列表中的一个值。 | 不要向您的客户报告更详细的信息。请按与 `generic_decline` 相同的方式显示。 |
| `new_account_information_available` | 该卡或它关联的账户无效。 | 客户需要联系发卡行来了解更多信息。 |
| `no_action_taken` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| `not_permitted` | 该笔付款未被准许。 | 客户需要联系发卡行来了解更多信息。 |
| `offline_pin_required` | 该卡被拒绝了，原因是需要提供 PIN。 | 客户需要通过插入银行卡并输入 PIN 来重试。 |
| `online_or_offline_pin_required` | 该卡被拒绝了，原因是需要提供 PIN。 | 如果读卡器支持在线密码 (Online PIN)，则在不创建新交易的情况下提示客户输入 PIN。如果读卡器不支持在线密码 (Online PIN)，则客户需通过插入银行卡并输入 PIN 来重试。 |
| `pickup_card` | 客户不能用这张卡进行这笔付款（可能已挂失或报了被盗）。 | 客户需要联系发卡行来了解更多信息。 |
| `pin_try_exceeded` | 已超过了允许尝试的 PIN 输入次数。 | 客户必须使用其他银行卡或支付方式。 |
| `processing_error` | 处理银行卡时发生了错误。 | 要求客户再次尝试支付。如果仍然无法处理，客户需要联系其发卡行。 |
| `reenter_transaction` | 发卡行无法处理这笔付款，原因未知。 | 需再次尝试付款。如仍无法处理，则客户需要联系其发卡行。 |
| `restricted_card` | 客户不能用这张卡进行这笔付款（可能已挂失或报了被盗）。 | 客户需要联系发卡行来了解更多信息。 |
| `revocation_of_all_authorizations` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| `revocation_of_authorization` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| `security_violation` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| `service_not_allowed` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| `stolen_card` | 该笔付款被拒绝了，原因是该卡报了被盗。 | 不要向您的客户报告更详细的信息。请按与 `generic_decline` 相同的方式显示。 |
| `stop_payment_order` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| `testmode_decline` | 使用的是 Stripe 测试卡号码。 | 付款时必须使用真卡。 |
| `transaction_not_allowed` | 该卡被拒绝了，原因未知。 | 客户需要联系发卡行来了解更多信息。 |
| (已弃用)`try_again_later` | 该卡被拒绝了，原因未知。 | 让客户再次尝试支付。如果之后的付款被拒绝，则客户需要联系发卡行来了解更多信息。 |
| `withdrawal_count_limit_exceeded` | 该客户超出了他银行卡的余额或信用额度。 | 客户需要使用另一支付方式。 |
| `mobile_device_authentication_required` | 银行卡因交易需要身份验证而被拒付。 | 要求客户再次轻触其移动设备来重试支付。 |

## 本地支付方式拒付代码

以下 Stripe 拒绝代码可用于本地支付方式 (LPM) 支付：

| 拒付代码 | 收款结果原因 | 卖方消息 | API 错误信息 |
| --- | --- | --- | --- |
| `partner_generic_decline` | `partner_generic_decline` | 支付服务商拒绝了付款。 | 支付服务商拒绝了付款。 |
| `customer_declined` | `generic_decline` | 客户拒绝了该付款。 | 客户拒绝了这笔付款。 |
| `code_invalid` | `generic_decline` | BLIK 代码无效或格式错误。 | 传入的代码不是有效的 BLIK 代码。 |
| `code_expired` | `generic_decline` | BLIK 代码已过期、已被使用或已超出有效期。 | 传入的代码已过期。BLIK 代码会在 2 分钟后过期，请向客户请求另一个代码。 |
| `invalid_customer_account` | `invalid_customer_account` | 我们无法对该客户的账户扣款。 | 我们无法对该客户的账户扣款。在客户采取行动解决其账户问题后，可能会重试成功。 |
| `payment_limit_exceeded` | `payment_limit_exceeded` | 订单超过了客户账户的限额。 | 订单超过了客户账户的限额。在客户采取行动解决其账户问题后，可能会重试成功。 |
| `invalid_billing_agreement` | `invalid_billing_agreement` | 客户的计费协议无效。 | 该客户的支付方式无效，原因是计费协议无效。重试不会成功。 |
| `expired_card` | `partner_expired_card` | 在支付服务商处注册的银行卡已过有效期。 | 在支付服务商这里注册的卡已过期。在客户采取行动来解决其账户问题后，可能会重试成功 |
| `processing_error` | `partner_processing_error` | 支付服务商在处理时发生了错误。 | 支付服务商在处理时发生了错误。 |
| `insufficient_funds` | `partner_insufficient_funds` | 客户在支付服务商处的资金不足。 | 客户在支付服务商处的资金不足。在客户采取行动来解决其账户问题后，可能会重试成功 |
| `currency_not_supported` | `partner_invalid_currency` | 支付服务商不支持该货币。 | 支付服务商不支持此货币。重试不会成功。 |
| `invalid_amount` | `partner_invalid_amount` | 支付服务商不允许该金额。 | 支付服务商不允许该金额。重试不会成功。 |
| `invalid_business_account` | `invalid_business_account` | 商家账户已停用。 | 您尝试用来处理付款或退款的商家账户已停用，无法收发资金。如果重新激活账户，可能会重试成功。 |
| `partner_high_risk_customer` | `partner_high_risk_customer` | 支付服务商将该客户标记为高风险。 | 支付服务商将该客户标记为高风险。 |
| `compliance_violation` | `compliance_violation` | 这笔付款违反了服务条款、计划规则或适用法律。 | 这笔付款违反了服务条款、计划规则或适用法律。重试不会成功。 |
| `payment_disputed` | `payment_disputed` | 这笔付款有争议。 | 这笔付款有争议。如果以有利于商家的方式解决争议，可能会重试成功。 |
| `invalid_authorization` | `invalid_authorization` | 授权无效或已被撤回。 | 这笔付款未收到授权，或撤销了其授权。重试不会成功。 |
| `invalid_payment_information` | `invalid_payment_information` | 这笔付款包含无效信息。 | 这笔付款包含无效信息。重试不会成功。 |
| `partner_payment_not_found` | `partner_payment_not_found` | 支付服务商找不到这笔付款。 | 支付服务商找不到这笔付款。 |
| `expired_payment_information` | `expired_payment_information` | 相关支付工具有效期已过。 | 支付信息已过期。客户更新其支付信息后，重试可能会成功。 |
| `duplicate_transaction` | `partner_duplicate_transaction` | 最近提交了一笔详细信息完全相同的交易。 | 最近向合作伙伴提交了一笔详细信息完全相同的交易。 |
| `recurring_not_supported_by_bank` | `recurring_not_supported_by_bank` | 客户的银行不支持此支付方式的定期付款。 | 客户的银行不支持此支付方式的定期付款。请提示客户选择支持定期付款的银行。 |
| `partner_action_not_supported` | `partner_action_not_supported` | 支付服务商不支持此操作。 | 支付服务商不支持此操作。重试不会成功。 |
| `lost_or_stolen_card` | `lost_or_stolen_card` | 支付被拒绝，因为此银行卡已被挂失或被盗。 | 拒绝的具体原因不应告知客户。而是应将其显示为 `partner_generic_decline`。 |
| `card_already_activated` | `card_already_activated` | 此银行卡已激活。 | 此银行卡已激活。重试不会成功。 |
| `invalid_track_data` | `invalid_track_data` | 银行卡数据不正确。 | 银行卡数据不正确。客户需要联系其发卡行，检查银行卡是否能正常使用。 |