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 付款：
对于 USD checkout，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。
对于 USD checkout，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）可在测试模式下进行测试。
Multibanco 显示的是 voucher，而不是银行支付流程。请参阅 Test Multibanco。
1

Enable test mode

在 dashboard 侧边栏中关闭 Live Mode 开关，并使用在 test mode 中创建的 API keys。请参阅 Test Mode vs Live Mode。
2

Set billing address

将 billing address 的国家/地区设置为与 payment method 匹配：
  • NL 用于 iDEAL
  • BE 用于 Bancontact
  • AT 用于 EPS
  • PT 用于 Multibanco
3

Set currency

欧洲支付方式要求使用 EUR currency。
4

Complete test flow

在 test environment 中按照模拟的银行认证流程操作。

​
Test Multibanco

使用 EUR 和 PT billing address。点击 Pay 后，checkout 会显示 Multibanco voucher。在 test mode 中，你输入的 email 会决定结果： 要查看成功页面，请使用 succeed_immediately@example.com，等待几秒钟，然后点击 Done。 完整的 test emails 列表请参阅 Europe 页面。

​
Test SEPA Direct Debit IBANs

SEPA Direct Debit 要求使用 EUR 和 Eurozone billing address。使用以下 test IBANs 可强制生成特定结果： 完整的 test IBANs 列表（包括各国家/地区的值）请参阅 Europe 页面。 完整的 European payment methods 文档请参阅 Europe 页面。

​
Test Asia-Pacific Wallets

GCash、Alipay HK、FPS 和 Touch ‘n Go 是 QR code payments，仅在 billing country 和 currency 匹配时显示。
1

Enable test mode

在 dashboard 侧边栏中关闭 Live Mode 开关，并使用在 test mode 中创建的 API keys。请参阅 Test Mode vs Live Mode。
2

Set billing country and currency

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

Select the method and confirm

选择 payment method 并点击 Pay。QR code 会在全屏 overlay 中打开，checkout 会等待 payment。
4

Verify the checkout behavior

确认该 payment method 仅在匹配的国家/地区和 currency 下显示，并且 QR code 能够正常渲染。
test-mode QR codes 由 wallet provider 的 test environment 签发，其行为可能与 live payment 不同。
完整文档请参阅 Asia-Pacific 页面。

​
Testing Best Practices

不要只测试成功的 payment。请测试 declines、cancellations，以及资金不足等 edge cases。
确保你的 webhook endpoints 能正确处理所有 event types，尤其是 payment.succeeded、payment.failed 和 subscription events。使用 Dodo Payments CLI 在本地测试 webhooks：
  • dodo wh listen 将 live test webhooks 转发到本地服务器
  • dodo wh trigger 为所有受支持的 webhook event types 发送 mock payloads
对于 Apple Pay 和 Google Pay，请在实际的 iOS 和 Android 设备上进行测试。Simulators 无法完全复现 wallet behavior。
Regional payment methods（UPI、iDEAL 等）要求匹配的 billing addresses。US billing address 不会显示 iDEAL。
Klarna 和 Afterpay 在 USD checkouts 中要求最低金额为 $50.01。请测试它们是否会根据 cart total 正确显示或隐藏。

Cards

Card testing、3D Secure 和 saved payment methods。

Digital Wallets

Apple Pay、Google Pay 和 Amazon Pay testing。

BNPL

Klarna、Afterpay 和 Billie testing。

India

UPI 和 RBI mandate testing。

Pix

使用 test CPF 进行 Pix testing。

Europe

iDEAL、Bancontact、EPS 和 Multibanco testing。

Asia-Pacific

GCash、Alipay HK、FPS 和 Touch ‘n Go testing。

Webhooks

为 test events 设置 webhooks。

CLI Webhook Testing

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