# Stripe 拒绝代码

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

Stripe 使用自己的拒付代码，涵盖许多与[发卡行拒付代码](https://docs.stripe.com/declines/network-codes.md)相同的潜在原因。我们的拒付代码在发卡行拒付代码基础上进一步细化，更具体地说明了拒付的具体原因。除了拒付码外，错误还可包含 [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`                          | 该卡被拒绝了，原因未知。                                                                                                                                                                                      | 客户需要联系发卡行来了解更多信息。                                                                                                                                                                                                                                                                                                                                                                                            |
| (deprecated)`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`               | 该卡被拒绝了，原因未知。                                                                                                                                                                                      | 客户需要联系发卡行来了解更多信息。                                                                                                                                                                                                                                                                                                                                                                                            |
| (deprecated)`try_again_later`           | 该卡被拒绝了，原因未知。                                                                                                                                                                                      | 让客户再次尝试支付。如果之后的付款被拒绝，则客户需要联系发卡行来了解更多信息。                                                                                                                                                                                                                                                                                                                                                                      |
| `withdrawal_count_limit_exceeded`       | 该客户超出了他银行卡的余额或信用额度。                                                                                                                                                                               | 客户需要使用另一支付方式。                                                                                                                                                                                                                                                                                                                                                                                                |
| `mobile_device_authentication_required` | 银行卡因交易需要身份验证而被拒付。                                                                                                                                                                                 | 再次轻触您的移动设备以重试。                                                                                                                                                                                                                                                                                                                                                                                               |

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

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

| 拒付代码                              | 收款结果原因                            | 卖方消息                   | API 错误信息                                      |
| --------------------------------- | --------------------------------- | ---------------------- | --------------------------------------------- |
| `partner_generic_decline`         | `partner_generic_decline`         | 支付服务商拒绝了付款。            | 支付服务商拒绝了付款。                                   |
| `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` | 客户的银行不支持此支付方式的定期付款。    | 客户的银行不支持此支付方式的定期付款。请提示客户选择支持定期付款的银行。          |