Stripe银行卡验证失败怎么办？按错误代码排查
简答：Stripe银行卡验证失败，不一定是Stripe账户被限制。先查看页面或接口返回的错误代码：incorrect_cvc、incorrect_number、expired_card通常先改卡片资料；authentication_required要完成3D Secure验证；generic_decline、do_not_honor或银行未提供明确原因时，应联系发卡行确认境外线上支付是否被拦截。不要连续重复提交，也不要用虚假账单地址或邮编。
定义：Stripe银行卡验证失败，是银行卡在添加、保存或支付确认阶段未通过卡片资料校验、发卡行授权、地址验证或3D Secure身份验证的统称。
先看错误代码：确定是哪一层失败
先不要急着换卡或反复点击提交。Stripe的错误对象通常包含type、code、decline_code、message等字段；其中decline_code是在发卡行提供原因时返回的拒绝原因。商家可以在PaymentIntent的last_payment_error、相关Charge或失败事件中查看这些信息。具体字段定义可参考Stripe错误对象说明和Stripe银行卡拒绝说明。
| 看到的代码或现象 | 通常表示 | 先做什么 |
|---|---|---|
incorrect_number | 卡号格式或卡号本身未通过校验 | 重新输入卡号，确认没有多余空格或数字遗漏 |
incorrect_cvc | CVC或CVV校验失败 | 按实体卡背面或银行页面显示的安全码重新填写 |
expired_card | 有效期已过或填写格式不正确 | 核对月份、年份与卡片有效期 |
incorrect_zip、地址校验失败 | 账单邮编或地址信息与发卡行记录不一致 | 填写真实账单信息，不要把收货地址代替账单地址 |
authentication_required | 这笔交易需要额外身份验证 | 完成银行页面、短信、银行App或其他3D Secure步骤 |
card_declined、generic_decline、do_not_honor | 发卡行拒绝，或未提供足够具体的原因 | 核对卡片资料后联系发卡行确认交易 |
| 页面白屏、按钮无响应、跳转失败 | 可能是浏览器会话、支付页面脚本或网络连接问题 | 先保存错误时间和订单信息，再用干净会话复测 |
代码只能帮助分流，不能保证直接说明真实原因。Stripe明确指出，很多银行卡拒绝会以通用原因返回，发卡行通常只向持卡人解释具体拦截原因。
按这个顺序排查银行卡验证失败
- 先确认操作类型。如果是在保存银行卡或订阅前添加卡片，可能属于PaymentMethod或SetupIntent验证；如果是在付款页面点击支付，则重点看PaymentIntent、Charge或付款失败提示。两者都可能出现卡片资料错误、发卡行拒绝或3D Secure验证失败，不要只根据“验证失败”四个字判断账户状态。
- 重新核对卡片资料。逐项检查卡号、有效期、CVC/CVV、持卡人姓名，以及页面要求的国家、州省、城市、街道和邮编。账单地址应使用发卡行记录中的真实信息；不要为了通过校验而编造地址。Stripe的卡片对象中包含账单地址、邮编和CVC校验结果等字段，商家可以据此定位是否是地址或安全码检查失败，相关字段可查看Stripe卡片字段说明。
- 检查3D Secure是否完成。如果页面跳转到银行验证页面，不能只等待原页面自动返回。完成短信、银行App确认或页面挑战后，再回到商户页面查看结果。若页面中途关闭、验证超时、验证页面无法加载，先重新打开原支付流程，不要直接连续刷新并提交多次。Stripe的支付确认流程可能显示3D Secure对话框或跳转到银行授权页面，官方集成说明见Stripe支付确认与3D Secure说明。
- 再判断是否是发卡行拦截。当代码是
generic_decline、do_not_honor、card_declined，且卡号、有效期、CVC和账单信息都正确时，优先联系发卡行。向银行客服描述“境外线上银行卡交易”或“无卡支付授权失败”，并提供交易时间、币种、金额和商户名称；不要向客服发送完整卡号、CVC或短信验证码。 - 最后检查浏览器和会话。退出支付页后重新打开官方商户页面，确认浏览器允许必要的Cookie和弹窗，关闭会影响支付页面运行的脚本拦截扩展，并避免在多个设备之间反复切换。若只有一个浏览器失败，可用同一设备的另一个常用浏览器复测；若多个浏览器、多个网络环境都失败，继续改浏览器的意义通常不大，应回到卡片资料和发卡行授权层排查。
如果你是商家或开发者，还可以在Dashboard中按付款编号、客户邮箱、卡号末四位等信息定位记录。Stripe提供了Dashboard搜索入口和搜索字段说明，具体操作可参考Dashboard搜索说明。
中国用户最容易填错的三个地方
1. 账单地址和收货地址混用
账单地址不是随便填写的收货地址。若支付页面要求账单地址，应优先按照发卡行登记的信息填写；如果银行记录只有中文地址，而页面使用英文或拼音字段，应保持地址含义一致，并按页面要求拆分街道、城市、地区和邮编。无法确认银行记录时，不要为了“匹配格式”自行编造国外地址。
2. 把银行卡验证失败当成余额不足
余额不足只是其中一种可能。错误也可能来自卡片过期、CVC错误、地址校验失败、境外线上支付未授权、商户类别限制、3D Secure未完成或银行风控。Stripe官方将卡片资料错误、资金或额度问题、疑似欺诈以及卡片使用范围限制都列为可能的拒绝原因，因此应先按代码分流，而不是直接反复换卡。
3. 以为所有银行App都有相同入口
不同银行的菜单名称、开关位置和人工审核流程可能变化。本文没有核实并列出招行、建行、工行等银行的固定App路径，也不建议照搬网络文章中的截图。可在发卡行App内搜索“境外支付”“网上支付”“无卡支付”“交易限额”等关键词；如果找不到，直接联系发卡行确认该卡是否允许当前类型的境外线上交易，并询问是否需要临时授权。银行确认后，再回到原页面完成一次新的支付尝试。
失败后多久重试？按返回结果决定
Stripe没有针对所有银行卡验证失败场景规定一个统一的“等待15分钟”或“等待24小时”规则，因此不能把固定等待时间当成通用答案。更可靠的做法是根据错误类型处理：
| 返回结果 | 重试策略 | 不要做的事 |
|---|---|---|
| 资料字段错误 | 修正一个明确错误后再提交一次 | 不改资料连续提交 |
authentication_required | 完成3D Secure后重新查看支付状态 | 跳过验证页面或关闭验证窗口后反复点击 |
try_again_later | 完成资料核对后再安排一次复试 | 短时间内大量重复授权 |
do_not_try_again | 停止使用同一笔交易继续尝试，联系发卡行或改用合规的其他支付方式 | 连续重复同一张卡和同一笔订单 |
原因不明的generic_decline | 先向发卡行确认，再决定是否重新发起 | 仅靠清缓存或更换设备反复试错 |
Stripe说明，部分允许重试的扣款会受到卡组织和发卡行重试次数限制，过多重试还可能被判断为可疑行为。因此，排查重点应是找到具体原因，而不是增加提交次数。
商家开发者如何记录并定位失败
如果你经营自己的支付页面，不要只把“银行卡验证失败”展示给用户。服务端应记录PaymentIntent或SetupIntent编号、错误类型、错误代码、拒绝代码、失败消息和请求时间，同时避免记录完整卡号和CVC。Stripe官方错误对象中提供了decline_code、message、payment_intent和setup_intent等字段，可用于把前端提示和后台日志对应起来。
建议使用下面的记录格式：
时间：YYYY-MM-DD HH:mm:ss
操作：添加银行卡 / 一次性付款 / 订阅续费
对象：PaymentIntent 或 SetupIntent
code：card_declined
decline_code：generic_decline
3DS：未触发 / 已触发但失败 / 已完成
地址校验：pass / fail / unavailable / 未返回
处理：已核对资料 / 已联系发卡行 / 等待再次尝试测试集成时不要使用真实银行卡。Stripe提供测试卡来模拟card_declined、incorrect_cvc、余额不足、地址检查失败和3D Secure等场景；测试卡只应配合测试密钥和测试环境使用，具体列表见Stripe测试卡说明。如果是商家自己的支付页面，还可以结合相关排查指南继续处理：付款整体失败可查看Stripe支付失败排查，3D Secure问题可查看Stripe 3D Secure验证失败，资料或身份审核问题可查看Stripe身份验证失败。
处理结论：什么时候应停止自行尝试
- 卡号、有效期、CVC和账单信息都已确认无误，但仍返回
generic_decline或do_not_honor。 - 银行App或短信验证已经完成，但支付仍返回
authentication_required或card_declined。 - 银行明确表示该卡不支持当前境外线上交易、商户类别或币种。
- 同一笔交易已经多次失败，错误信息没有变化。
遇到以上情况，继续刷新页面通常不能解决发卡行授权问题。保存交易时间、金额、币种、商户名称和错误代码，联系发卡行核实；如果你是商家，则同时检查PaymentIntent或SetupIntent日志、3D Secure返回结果和地址校验字段。不要提供完整卡号、CVC、短信验证码或银行登录密码。
常见问题
Stripe银行卡验证失败，是Stripe账户被封了吗？
不一定。卡片资料错误、发卡行拒绝、地址校验失败和3D Secure未完成，都可能显示验证或支付失败。只有看到明确的账户审核或账户限制提示时，才应按账户层面的流程处理；单独的card_declined不能直接证明账户被限制。
看到generic_decline，自己还能解决吗？
先检查卡号、有效期、CVC和账单地址；如果资料无误，generic_decline通常没有足够细节让持卡人单独判断。Stripe说明，发卡行可能只向持卡人解释具体拒绝原因，因此应联系发卡行确认该笔境外线上交易是否被拦截。
3D Secure验证成功后为什么仍然失败？
3D Secure完成只表示额外验证步骤完成，不等于发卡行最终一定授权。支付仍可能因额度、卡片限制、商户类别、地址检查或其他授权原因失败。应查看最终返回的错误代码，不要只根据“验证成功”判断付款已完成。
账单邮编应该填什么？
填写与发卡行账单记录对应的邮编或页面要求的账单邮编，不要为了通过校验随意填写。若不清楚银行记录，应向发卡行确认后再提交；不要用虚构地址替代真实账单信息。
失败后可以立刻换很多张卡测试吗？
不建议把连续换卡和重复提交作为首选排查方式。先根据错误代码修正明确问题；如果返回do_not_try_again，应停止同一笔交易的继续尝试；如果原因不明，应先联系发卡行或商家确认状态。
常见问题
Stripe银行卡验证失败，是Stripe账户被封了吗？
不一定。资料错误、发卡行拒绝、地址校验失败和3D Secure未完成都可能导致失败。单独的card_declined不能证明账户被限制。
generic_decline应该怎么处理？
先核对卡片资料和账单地址；如果都正确，联系发卡行确认境外线上交易是否被拦截。generic_decline通常不会提供足够具体的原因。
3D Secure验证成功后仍然失败怎么办？
3D Secure完成不等于最终授权成功。继续查看最终错误代码，排查额度、卡片限制、地址检查和发卡行授权结果。
Stripe失败后多久可以重试？
没有适用于所有场景的统一等待时间。修正明确错误后再尝试一次；如果返回do_not_try_again或多次失败，应停止重复提交并联系发卡行。
账单邮编填错会导致银行卡验证失败吗？
可能会。应填写与发卡行记录对应的真实账单邮编，不要用虚构地址或收货地址替代。