测试

要确认您的集成能否正常工作，可以在不转移任何资金的情况下，在测试模式或沙盒中用特殊的值来模拟交易。

测试卡充当假信用卡，并允许您模拟以下几种情况：

• 按卡品牌或国家/地区成功付款
• 因银行拒付、欺诈或无效数据造成的卡错误
• 争议和退款
• 用 3DS 验证和 PIN 验证

测试非银行卡支付的方式与此类似。每个支付方式都有其自己的特殊值。由于速率限制，不建议使用测试环境对您的集成进行负载测试。相关替代方案请参阅负载测试。

如何使用测试卡

每次使用测试卡时，请在所有 API 调用中使用测试 API 密钥。无论是提供可交互测试的支付表单，还是编写测试代码，都该这样做。

交互测试

交互测试时，使用一个卡号，例如 4242 4242 4242 4242。在管理平台或任意支付表单中输入该卡号。

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

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

测试代码

编写测试代码时，请使用 PaymentMethod（例如 pm_card_visa）而非卡号。不建议直接在 API 调用或服务器端代码中使用这些卡号，即使是在测试环境中。如果一定要使用它们，您的代码在上线时可能会出现不合规的情况。默认情况下，PaymentMethod 不会附加到 Customer。

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 联名的。下表中的测试卡模拟的是使用联名卡成功付款的情形。

银行卡（按国家/地区）

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

拒绝付款的情形

要通过模拟发卡行因各种原因拒绝的付款来测试您的集成的错误处理逻辑，请使用此部分的测试卡。使用包含给定错误代码和拒付代码的银行卡错误中的这些结果之一。

欺诈预防

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

每张卡模拟一些具体的风险因素。您的 Radar 设置决定着哪些风险因素会使 Radar 阻止付款。被阻止的付款会产生附有欺诈错误代码的银行卡错误。

数据无效

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

• invalid_expiry_month：使用一个无效的月份，例如13。
• invalid_expiry_year：使用过去最长 50 年中的一个年份，例如95。
• invalid_cvc：使用一个两位数卡号，例如99。
• incorrect_number: 使用不能通过 Luhn 检查的卡号，例如 4242424242424241
  。

争议

要模拟有争议的交易，请使用此部分的测试卡。然后，模拟赢了或输了争议的情形，提供赢或输的证据。

证据

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

• 如果您用 API 进行响应，请以 uncategorized_text 传递此表中的值。
• 如果您在管理平台中响应，请在其他信息字段输入此表中的值。然后，点击提交证据。

退款

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

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

可用余额

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

3DS 验证

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

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

验证和设置

要模拟包含验证的付款流程，请使用此部分的测试卡。一些卡也可以设置为供未来付款所用，或已经这样设置了。

支持及可用性

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

3DS 验证移动端验证流程

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

验证码验证

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

用 PIN 码付款

用此部分的测试卡模拟涉及 PIN 码且成功地线下付款的情形。还有很多测试线下付款的选项，包括模拟的读卡器和物理测试卡。有关更多信息，请查看测试 Stripe Terminal。

事件接收端

To test your webhook endpoint or event destination, choose one of these two options:

1. Perform actions in a sandbox that send legitimate events to your event destination. For example, to trigger the charge.succeeded event, you can use a test card that produces a successful charge.
2. Trigger events using the Stripe CLI or using Stripe for Visual Studio Code.

速率限制

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

在测试环境中，我们不建议用 Stripe API 对您的集成应用进行负载测试。原因是测试环境中的负载限制器更严格，会导致您在生产环境中看到不希望看到的错误。关于替代方式，请查看负载测试。

非卡支付方式

每次使用测试用的非卡支付方式时，请在所有 API 调用中使用测试 API 密钥。无论是提供可交互测试的支付表单，还是编写测试代码，都该这样做。

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

Link

Currently, Link only works with credit cards, debit cards, and qualified US bank account purchases. Link requires domain registration.

You can create sandbox accounts for Link using any valid email address. The following table shows the fixed one-time passcode values that Stripe accepts for authenticating sandbox accounts:

多个资金来源

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

重定向

要通过模拟使用重定向流程（例如，iDEAL）的付款来测试您的集成的直接处理逻辑，可使用支持的要求重定向的支付方式。

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

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

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