测试

要测试您的集成应用，可在沙盒中使用特殊测试值模拟交易，而无需实际转账。您可以使用页面右上角的账户选择器或管理平台访问您的沙盒。

测试银行卡充当虚拟信用卡，可以模拟以下情境：

• 按银行卡品牌或国家排序的成功支付
• 由于拒付、欺诈或无效数据而导致银行卡出错
• 争议和退款
• 使用3DS 验证和PIN 码进行验证

测试非银行卡支付的工作原理与此类似。非银行卡支付是指除信用卡或借记卡之外的其他支付方式。Stripe 支持各种非银行卡支付方式，如数字钱包和银行转账。每种支付方式都有自己的特殊值。

不要使用测试环境对集成进行负载测试，因为可能遇到速率限制。要对集成应用进行负载测试，请参阅负载测试。

如何使用测试卡

在使用测试银行卡时，请在所有 API 调用中使用测试 API 密钥。无论您是提供支付表单进行交互式测试，还是编写测试代码，都应如此。

交互测试

交互式测试时，请使用银行卡号，如4242 4242 4242 4242。在管理平台或任何支付表单中输入该卡号。

• 使用有效的未来日期，例如 12/34。
• 使用任意三位数 CVC（American Express 卡为四位）。
• 其他表单字段可以使用任意值。

用测试卡卡号 4242 4242 4242 4242 交互式地测试表单

测试代码

编写测试代码时，请使用PaymentMethod，如pm_card_visa，而不要使用银行卡号。我们不建议在 API 调用或服务器端代码中直接使用银行卡号，即使在测试环境中也是如此。如果使用了，上线时代码可能不符合 PCI 标准。默认情况下，PaymentMethod不会绑定到 客户。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=500 \
  -d currency=gbp \
  -d payment_method=pm_card_visa \
  -d "payment_method_types[]"=card

大多数集成应用不再使用令牌，但如果您需要，我们会提供测试令牌，如tok_visa。

准备好将您的集成应用上线时，将您测试用的可发布的和秘密的 API 密钥换成真实密钥即可。如果您的集成应用仍在使用您的测试 API 密钥，则您不能处理真实付款。

银行卡（按品牌）

要模拟特定银行卡品牌的成功付款，请使用以下列表中的测试卡。

多数 Cartes Bancaires 和销售点电子转账卡是与 Visa 或 Mastercard 联名的。下表中的测试卡模拟的是使用联名卡成功付款的情形。

银行卡（按国家/地区）

要模拟特定国家的成功付款，使用以下部分的测试卡。

HSA 和 FSA 测试银行卡

以下是模拟使用健康储蓄账户 (HSA) 和灵活消费账户 (FSA) 进行交易的测试银行卡号。这些账户通常用于支付医疗费用，用其进行测试可确保在您的应用程序中正确处理与医疗保健相关的交易。

拒绝的付款

要通过模拟发卡行因各种原因拒付的支付来测试集成的错误处理逻辑，请使用本节中的测试银行卡。使用这些卡片中的一张，会产生银行卡错误，并给出错误代码和拒付代码。

欺诈预防

在付款具有高风险等级或未通过验证检查时，Stripe 的欺诈预防系统 Radar 可以阻止付款。您可以用此部分的卡测试您的 Radar 设置，还可以用这些卡来测试您的集成应用对被阻止付款的响应情况。

每张银行卡都模拟特定的风险因素。您的 Radar 设置决定了哪些风险因素会导致支付被阻止。被阻止的支付会导致银行卡错误，错误代码为欺诈。

数据无效

要测试无效数据造成的错误，请提供无效信息。不需要为此使用专门的测试卡。任何无效值均可。例如：

• invalid_expiry_month：使用无效月份，如13。
• invalid_expiry_year：使用过去 50 年以内的年份，如95。
• invalid_cvc：使用两位数，如99。
• incorrect_number ：使用未通过Luhn 检查的银行卡号，如 4242424242424241
  。

争议

要模拟有争议的交易，请使用本节中的测试银行卡。然后，为了模拟争议的胜诉或败诉，请提供胜诉或败诉的证据。

证据

要模拟争议胜诉或败诉的情形，请用下表中的某个证据值来响应。

• 如果使用 API 进行响应，请将表中的值作为uncategorized_text传入。
• 如果您在管理平台或 Connect 嵌入式组件 中作出回应，请在其他信息字段中输入表中的值。随后，点击提交证据。

退款

真实模式下的退款是异步的：退款可能看上去是成功的，然后会失败；也可能先是pending，然后成功。要模拟包含这些行为的退款，请使用此部分的测试卡。（对于其他所有测试卡，退款会立即成功，且之后不会更改状态。）

只能通过管理平台取消银行卡退款。在真实模式下，您可以在很短但非特定的时间内取消银行卡退款。测试环境会模拟这段时间，允许您在 30 分钟内取消银行卡退款。

可用余额

要将测试交易中的资金直接发送到您的可用余额，请使用此部分的测试卡。其他测试卡会将从成功付款得到的资金发送到您的待收余额。

3DS 验证

3DS 验证要求对信用卡交易进行额外一层验证。本节中的测试卡可供您在不同的支付流程中模拟如何触发身份验证。

只有本节中的卡可以通过模拟定义的 3DS 验证行为（如验证流程或不支持的卡）来有效测试您的 3DS 验证集成应用。其他 Stripe 测试卡可能仍会触发 3DS 验证，但我们会返回attempt_acknowledged以绕过额外的步骤，因为 3DS 验证测试不是这些卡的目标。

验证和设置

要模拟包含身份验证的支付流程，请使用本节中的测试银行卡。其中一些银行卡还可以设置用于未来的支付，或者已设置完成。

支持及可用性

有法规要求，或者您的 Radar 规则或自定义代码触发时，Stripe 会要求验证。即使是请求了验证，也并非总是执行——例如，客户的卡可能未注册，或可能发生错误。用此部分的测试卡模拟这些因素的各种组合。

3DS 验证移动端验证流程

在移动端付款时，可以使用多个验证流程——客户必须与 UI 中的提示信息交互。用此部分的测试卡，为测试而触发特定的验证流程。这些卡不能在基于网页的支付表单或 API 调用中使用。在上述环境中，这些卡能用，但不会触发任何特殊行为。因为这些卡在 API 调用中无法使用，我们不提供测试用的任何PaymentMethod或Token值。

验证码验证

为防止欺诈，Stripe 可能会在支付页面上向用户显示验证码验证。用下方的测试卡模拟该流程。

用 PIN 码付款

使用本节中的测试银行卡来模拟涉及 PIN 码且成功进行的当面支付。测试线下付款还有很多其他选择，包括模拟读卡器和实体测试银行卡。更多信息，请参阅测试 Stripe Terminal。

事件接收端

要测试您的 Webhook 端点或事件接收端，请选择以下两种选项之一：

1. 在沙盒中执行操作，将合法事件发送到您的事件接收端。例如，要触发 charge.succeeded 事件，您可以使用一个产生成功收款的测试卡。
2. 用 Stripe CLI 触发事件或使用 Stripe 的 Visual Studio Code。

速率限制

如果您在测试环境中的请求开始收到429 HTTP 错误，请降低请求的频率。这些错误来自我们的速率限制器，在测试环境中比在真实模式中更为严格。

我们不建议在测试环境中使用 Stripe API 对集成应用进行负载测试。因为测试环境中的负载限制器更为严格，可能看到在生产环境中不会出现的错误。请参阅负载测试了解替代方法。

非卡支付方式

使用非银行卡支付方式进行测试时，请在所有 API 调用中使用测试 API 密钥。无论您是提供支付表单进行交互式测试，还是编写测试代码，都应如此。

测试程序因支付方式而异：

Link

目前 Link 仅支持用信用卡、借记卡以及符合条件的美国银行账户进行购买。Link 需要域名注册。

您可以用任意有效的邮件地址为 Link 创建沙盒账户。下表显示的是 Stripe 接受的在验证沙盒账户时可使用的一次性固定密码值：

多个资金来源

由于 Stripe 增加了额外的资金来源支持，因此您不需要更新您的集成。Stripe 会自动为它们提供与卡和银行账户支付相同的交易结算时间和担保。

重定向

要通过模拟使用重定向流程的支付（例如 iDEAL）来测试集成的重定向处理逻辑，请使用需要重定向的支持性支付方式。

要创建成功或失败的测试PaymentIntent：

1. 导航至管理平台中的支付方式设置，并在测试环境中点击打开启用受支持的支付方式。
2. 收集付款详情。
3. 向 Stripe 提交付款。
4. 授权测试付款或让其失败。

确保您网站上的页面（对应于return_url）提供付款的状态。