Skip to main content
使用本页面上的测试凭据，在测试模式下模拟成功、拒绝和失败的付款。不会发生资金转移，也不会向真实账户扣款。要查看完整的测试付款流程，请观看此视频。

Full API Access

每个 API endpoint 都可在测试模式下使用。

Webhook Testing

测试交易会像生产环境中的交易一样触发 Webhooks。
测试凭据仅在测试模式下有效。在 live 模式下，使用测试凭据发起的付款会失败。

​
测试卡

使用以下卡号，在不同地区模拟成功和被拒绝的付款。
对于所有测试卡，请使用有效期 06/32（或 12/34）和 CVV 123。

​
测试续订失败

1

Create a test subscription

使用测试 API keys 和成功测试卡（例如 4242424242424242）创建订阅。初始扣款应成功，且订阅应变为 active。
2

Update the payment method

打开 Customer Portal，找到订阅，然后点击 Update Payment Method。输入失败测试卡 4000000000000341（有效期：12/34，CVV：123），然后保存。
3

Advance the next billing date (optional)

要立即触发续订，而不是等待自然计费周期，请使用 Update Subscription API 将 next_billing_date 设置为当前 UTC 时间，并替换下面的示例值。该值必须是 ISO 8601 / RFC 3339 UTC 时间戳（必须包含 Z 后缀）。
详情请参阅 Update Subscription API reference。
4

Verify the failure

在下一次计费尝试时：
  • 续订扣款会在失败卡上被拒绝
  • 订阅首先变为 Past Due（宽限期；subscription.past_due webhook 携带 past_due_ends_at），宽限期结束后变为 On-Hold
  • 会发送 payment.failed webhook event
  • 客户可以返回 Customer Portal 更新付款方式并重试

​
测试 UPI

UPI 测试使用特殊的 VPA（Virtual Payment Address）标识符来模拟不同的付款结果。

​
UPI 测试要求

  • Billing country 必须设置为 IN
  • Currency 必须为 INR
  • 对于非印度商家：必须启用 Adaptive Currency
有关完整的 UPI 文档（包括订阅的 RBI mandate 测试），请参阅 India Payment Methods 页面。

​
测试 Pix

Pix 测试使用测试 CPF（Brazilian tax ID）来模拟二维码流程。

​
Pix 测试要求

  • Billing country 必须设置为 BR
  • Currency 必须为 BRL
结账时出现提示后，输入测试 CPF。系统会生成测试二维码——使用手机的普通相机扫描（无需 Pix app），然后您会被重定向到测试页面，在那里可以将交易模拟为成功或失败。 有关完整的 Pix 文档，请参阅 Pix 页面。

​
测试 BNPL

Buy Now Pay Later 提供商有特定的测试数据要求。

​
Klarna 测试数据

使用以下信息在测试模式下模拟 Klarna 付款：
Klarna 要求最低交易金额为 $50.01，才能显示为付款选项。

​
Afterpay 测试

1

Select Afterpay

在结账时选择 Afterpay 作为付款方式，然后点击 Pay。
2

Test successful payment

成功付款时可以使用任意有效的 email address 和 shipping address。
3

Test failed authentication

要模拟失败，请在重定向页面上关闭 Afterpay modal window。付款会从 requires_customer_action 转换为 requires_payment_method。
Afterpay 要求最低交易金额为 $50.01，才能显示为付款选项。
有关完整的 BNPL 文档（包括 Billie B2B 测试），请参阅 Buy Now Pay Later 页面。

​
测试数字钱包

​
Apple Pay

1

Enable test mode

关闭 dashboard 侧边栏中的 Live Mode 开关，并使用在测试模式下创建的 API keys。请参阅 Test Mode vs Live Mode。
2

Add a card to Apple Wallet

将真实卡片添加到 Apple Wallet。在测试模式下，不会向该卡片扣款。
3

Complete test purchase

在 Apple 设备上打开结账并完成 Apple Pay 流程。
Apple Pay 需要 HTTPS。未正确配置 SSL 时，它不会显示在 localhost 上。Domain verification 也必须完成。

​
Google Pay

1

Join the test card group

Join the Google Pay test card group，即可自动将测试卡添加到您的钱包。
2

Enable test mode

关闭 dashboard 侧边栏中的 Live Mode 开关，并使用在测试模式下创建的 API keys。请参阅 Test Mode vs Live Mode。
3

Complete test purchase

在 Google Pay 中选择一张测试卡以完成交易。

​
Amazon Pay、Cash App Pay 和 RevolutPay

使用测试 API keys 并遵循标准结账流程。测试交易会在不实际扣款的情况下进行模拟。 有关完整的数字钱包文档（包括 Apple Pay 的 domain verification），请参阅 Digital Wallets 页面。

​
测试 ACH Direct Debit

可以在测试模式下通过结账时输入测试银行信息来测试 ACH Direct Debit。
1

Enable test mode

关闭 dashboard 侧边栏中的 Live Mode 开关，并使用在测试模式下创建的 API keys。请参阅 Test Mode vs Live Mode。
2

Set currency and billing address

将 billing currency 设置为 USD，并将 billing address country 设置为 US。除此组合外不提供 ACH。
3

Use a one-time payment

订阅结账不支持 ACH，因此请使用一次性付款进行测试。
4

Enter the test bank details

输入下面的一组测试 routing 和 account number，然后确认您的 webhook handler 收到最终付款状态——ACH 付款会异步确认，而不是在结账时确认。

​
测试银行账户

使用 routing number 110000000 以及以下任一 account number： 完整的测试账户列表请参阅 ACH Direct Debit 页面。

​
测试欧洲支付方式

欧洲支付方式（iDEAL、Bancontact、EPS、Multibanco）可在测试模式下进行测试。
1

Enable test mode

关闭 dashboard 侧边栏中的 Live Mode 开关，并使用在测试模式下创建的 API keys。请参阅 Test Mode vs Live Mode。
2

Set billing address

将 billing address country 设置为与支付方式匹配：
  • NL 用于 iDEAL
  • BE 用于 Bancontact
  • AT 用于 EPS
  • PT 用于 Multibanco
3

Set currency

欧洲支付方式需要 EUR currency。
4

Complete test flow

在测试环境中遵循模拟的银行身份验证流程。

​
测试 SEPA Direct Debit IBAN

SEPA Direct Debit 需要 EUR 和欧元区 billing address。使用以下测试 IBAN 强制触发特定结果： 完整的测试 IBAN 列表（包括各国家/地区的值）请参阅 Europe 页面。 有关完整的欧洲支付方式文档，请参阅 Europe 页面。

​
测试亚太地区钱包

GCash、Alipay HK、FPS 和 Touch ‘n Go 是二维码支付方式，仅在 billing country 和 currency 匹配时显示。
1

Enable test mode

关闭 dashboard 侧边栏中的 Live Mode 开关，并使用在测试模式下创建的 API keys。请参阅 Test Mode vs Live Mode。
2

Set billing country and currency

使用匹配的组合创建一次性结账：
3

Select the method and confirm

选择支付方式并点击 Pay。二维码会在全屏覆盖层中打开，结账页面会等待付款完成。
4

Verify the checkout behavior

确认该方式仅在匹配的国家/地区和 currency 下显示，并且二维码能够正常呈现。
测试模式二维码由钱包提供商的测试环境签发，其行为可能与实际付款不同。
完整文档请参阅 Asia-Pacific 页面。

​
测试最佳实践

不要只测试成功付款。还应测试拒绝、取消以及余额不足等边界情况。
确保您的 webhook endpoints 能正确处理所有 event types，尤其是 payment.succeeded、payment.failed 和 subscription events。使用 Dodo Payments CLI 在本地测试 webhooks：
  • dodo wh listen 将 live 测试 webhooks 转发到本地服务器
  • dodo wh trigger 为所有支持的 webhook event types 发送模拟 payloads
对于 Apple Pay 和 Google Pay，请在实际的 iOS 和 Android 设备上测试。模拟器无法完全复现钱包行为。
区域支付方式（UPI、iDEAL 等）需要匹配的 billing addresses。US billing address 不会显示 iDEAL。
BNPL 方式要求最低金额为 $50.01。请测试它们是否会根据购物车总额正确显示或隐藏。

​
相关页面

Cards

卡测试、3D Secure 和已保存的付款方式。

Digital Wallets

Apple Pay、Google Pay、Amazon Pay 测试。

BNPL

Klarna、Afterpay 和 Billie 测试。

India

UPI 和 RBI mandate 测试。

Pix

使用测试 CPF 测试 Pix。

Europe

iDEAL、Bancontact、EPS、Multibanco 测试。

Asia-Pacific

GCash、Alipay HK、FPS 和 Touch ‘n Go 测试。

Webhooks

为测试 events 设置 webhooks。

CLI Webhook Testing

使用 Dodo Payments CLI 在本地测试 webhooks。
最后修改于 2026年9月26日