Skip to main content
测试模式让您可以构建和测试集成,而无需处理真实支付。生产模式接受客户的真实交易。每种模式都有各自的 API 密钥、产品和 Webhook。

功能可用性

环境相关与环境无关

环境相关功能在每种模式中保留独立的数据。在一种模式中的更改不会影响另一种模式。 环境无关功能在两种模式之间共享同一组数据。您的账户设置、商家资料、银行账户和验证文件在测试模式和生产模式中相同,因此在任一模式中的更改都会应用到两种模式。

API 端点

使用以下主机名将请求路由到正确的环境:
  • 测试模式: https://test.dodopayments.com
  • 生产模式: https://live.dodopayments.com
大多数 SDK 使用客户端选项而非基础 URL 来选择环境,例如 TypeScript 中的 environment: 'test_mode'。PHP 和 C# SDK 则使用测试模式基础 URL。请参阅 SDK。

模式的工作方式

在测试模式下,每笔交易都会被模拟,不会发生资金转移。使用测试流程中的测试卡、UPI ID 和其他凭据来模拟成功和失败的支付。该页面还提供了完整测试支付流程的视频。测试凭据仅在测试模式下有效。 注册后即可使用生产模式。您的账户通过账户验证后,生产支付和打款功能才会启用。 产品、API 密钥和 Webhook 归属于创建它们的模式。要复用产品,请在测试模式下打开该产品,然后将其复制到生产模式。复制后的产品会保留原产品的详细信息。测试模式 API 密钥无法通过 live.dodopayments.com 进行身份验证,生产密钥也无法通过 test.dodopayments.com 进行身份验证。 开发期间,如需在本地计算机上接收测试模式 Webhook,请使用 CLI Webhook 监听器转发 Webhook(dodo wh listen)。

测试模式下的邮件

测试模式会将真实的客户邮件发送到真实的收件人地址,因此请使用您可以控制的地址。每封测试模式邮件的主题都以 [TEST MODE] 开头。每个商家每周最多可以发送 100 封测试模式邮件。 要停止测试模式下的客户邮件,请在设置 → 通信 → 邮件中关闭测试模式邮件。实时模式下的邮件不受影响。请参阅测试模式邮件和客户邮件日志。

在模式之间切换

要切换模式,请使用控制面板侧边栏中的实时模式开关。请使用与您当前工作模式对应的 API 密钥。

后续步骤

Testing Process

测试银行卡、UPI、BNPL、数字钱包和银行扣款。

Account Verification

启用实时支付和打款。
最后修改于 2026年10月8日