跳转到主要内容
当您通过自带处理器 (BYOP)连接 Adyen 作为您自己的处理器时，本指南适用。如果您需要帮助，请联系我们。

​
启用原始卡数据访问

在 Dodo 通过 Adyen 路由付款之前，您的 Adyen 账户需要启用原始卡数据访问。Adyen 要求通过 PCI DSS 合规性来保护此访问。由于 Dodo Payments 代表您处理原始卡数据并且是PCI DSS 一级合规，您只需向 Adyen 提供Dodo Payments 的合规证明 (AOC)，无需您自己的认证。

Dodo Payments PCI DSS Attestation of Compliance (AOC)

下载 Dodo Payments 的当前 AOC 并提交给 Adyen 支持以启用原始卡数据访问。
联系 Adyen 支持以请求为您的商家账户开启原始卡数据访问，并附上上述 AOC。

​
您需要准备的事项

要在 设置 → BYOP 中连接 Adyen，请从您的 Adyen 客户端区域收集三个值：
值来源
API 密钥开发者 → API 凭证
商家账户您的 Adyen 商家账户标识符
HMAC 密钥在设置 webhook 时生成
Adyen 将 测试 (ca-test.adyen.com) 和 实时 (ca-live.adyen.com) 凭证分开。在与您在 Dodo 中配置的模式匹配的环境中生成凭证。

​
步骤 1：生成 API 密钥

1

Open API credentials

在 Adyen 客户端区域，转到 开发者 → API 凭证。您需要管理 API 凭证或商家管理员角色。
2

Select your credential

选择 支付选项卡并选择您的凭证用户名（看起来像 ws_123456@Company.YourCompanyAccount）。
3

Generate the key

转到 服务器设置 → 认证，打开 API 密钥选项卡，然后选择 生成 API 密钥。
4

Copy it immediately

复制并安全储存密钥；离开页面后您将无法再次复制。新生成的密钥会立即生效，而以前的密钥在 24 小时内会继续工作。

​
步骤 2：找到您的商家账户

您的商家账户是 Adyen 用于处理交易的账户标识符。它显示在客户端区域顶部的账户选择器中（例如，YourCompany_ECOM）。您需要将其粘贴到 Dodo 的商家账户字段中。

​
步骤 3：设置 webhook 和 HMAC 密钥

当您保存 Adyen 连接时，Dodo 会生成一个Webhook Endpoint URL。将其添加为 Adyen 中的一项 webhook，并生成一个 HMAC 密钥。您需要商家管理员或商家技术整合人角色。
1

Create a webhook

在客户端区域，转到 开发者 → Webhooks 并选择 创建新 webhook。从列表中选择为标准 webhook类型选择添加。
2

Configure the webhook

  • 输入描述。
  • 切换启用，使其生效。
  • 在服务器配置下，将 Dodo 生成的 Webhook Endpoint URL 粘贴到 URL 字段中（必须是 HTTPS 并且可公开访问）。
3

Generate the HMAC key

在安全性下，在 HMAC 密钥 部分，选择 生成以创建新 HMAC 密钥。复制并安全储存它；稍后您将无法再次复制。然后选择 保存配置。
4

Paste the HMAC key into Dodo

返回 设置 → BYOP，将 HMAC 密钥粘贴到Webhook 签名密钥字段中，以完成连接。

Set up BYOP

按照完整的自带处理器设置流程。
保存后，使用 Dodo 中的验证连接来对 Adyen 进行测试调用，并在上线前确认您的 API 密钥、商家账户和 HMAC 密钥是否有效。

​
常见问题解答

Adyen 为每个 webhook 签名一个 HMAC 签名，以便接收者能够验证通知的完整性和来源。Dodo 使用您提供的 HMAC 密钥来验证来自您 Adyen 帐户的 webhooks。
创建后无法检索。请在 开发者 → API 凭证下生成新的 API 密钥，或在 webhook 设置中生成新的 HMAC 密钥，然后在 设置 → BYOP 中更新值。
不可以。请在匹配的环境（测试 ca-test.adyen.com 或实时 ca-live.adyen.com）中生成凭证，并在 Dodo 中的相应模式下进行配置。

​
参考资料

最后修改于 2026年6月18日