[TITLE]
Adyen 支付集成指南：配置步骤与手动捕获教程
[DESCRIPTION]
本文详细介绍如何在 Odoo 中集成荷兰支付公司 Adyen，包括在 Adyen 客户区创建账户、获取 API 与客户端密钥、设置 Webhook 与安全 HMAC、在 Odoo 中配置提供商以及手动捕获和测试模式的操作步骤。
[KEYWORDS]
Adyen, 支付, 配置, Odoo, 手动捕获, API密钥, 客户区, Webhook, 测试模式, 多部分捕获
[TRANSLATED_CONTENT]
Adyen
Adyen 是一家提供多种在线支付方式的荷兰公司。
:::: note
::: title
注意
:::
Adyen 仅对年交易额超过 1000 万或每月交易笔数不少于 1000 笔的客户开放。
::::
Adyen 配置 {#payment_providers/adyen/configure_dashboard}
如有必要，创建 Adyen 账户并登录 Adyen 客户区。
:::: tip
::: title
提示
:::登录测试账户以在不扣费的情况下尝试集成。准备好接受真实付款后，再切换到正式账户。
:::前往 Adyen 支持团队 开通 多部分捕获 功能。
在 Adyen 客户区，进入
Developers → API credentials，点击列表中的相应 API 凭证用户名，或点击Create new credential创建新凭证。在
Server settings区域，点击Generate API key，随后点击fa-copy（复制 API key）图标，将得到的值保存，用于后续payment_providers/adyen/configure_odoo步骤。在
Client settings区域，点击Generate client key，随后点击fa-copy（复制 API key）图标，将得到的值保存，同样用于payment_providers/adyen/configure_odoo步骤。在
Add allowed origins字段中填入你的 Odoo 网站 URL，点击Add。页面底部点击
Save changes保存。在左侧菜单中进入
Developers → Webhooks，点击Create new webhook。在弹出的
Create new webhook窗口中，点击Standard webhook行右侧的Add。在
Webhook generation表单的Server configuration部分，填写你的 Odoo 数据库URL，后接/payment/adyen/notification。在
Security部分，点击Generate生成 HMAC，随后点击fa-copy（复制 HMAC 到剪贴板）图标，将得到的值保存，用于payment_providers/adyen/configure_odoo步骤。页面底部点击
Save configuration保存配置。前往
Developers → API URLs，复制Prefix并保存，同样用于payment_providers/adyen/configure_odoo步骤。
Odoo 配置 {#payment_providers/adyen/configure_odoo}
- 前往 Adyen 支付提供商 页面
<payment_providers/add_new>。 - 在以下字段中填入 商户账户、API Key、Client Key、HMAC Key、API URL Prefix，这些值均来源于前面的 Adyen 配置步骤
<payment_providers/adyen/configure_dashboard>。 - 根据实际需求配置其余选项。
- 将 State（状态）字段设为 Enabled（已启用）。
:::: tip
::: title
提示
:::
如果想在不影响真实交易的情况下测试 Adyen <payment_providers/test-mode>，使用你的 测试账户 凭证，在 API URL Prefix 字段填写 [https://checkout-test.adyen.com]，并将 State 设置为 Test Mode（测试模式）。
::::
手动捕获
若需为 Adyen 支付启用 手动捕获 <payment_providers/manual_capture>，请按以下步骤操作：
- 前往 Adyen 支付提供商 页面
<payment_providers/add_new>。 - 切换到
Configuration（配置）标签页，勾选 Capture Amount Manually（手动捕获金额）。 - 登录你的 Adyen 客户区，进入
Settings → Company（账户管理 → 公司）页面。 - 在
General（常规）区域，点击fa-pencil（编辑属性）图标，打开Capture Delay（捕获延迟）字段的编辑。 - 在弹窗中将 Capture delay（捕获延迟）设为 Manual（手动），然后保存。
:::: note
::: title
注意
:::
- 若交易在 7 天内未被捕获，客户有权撤销该交易。
- 你可以在 Adyen 客户区直接手动捕获
<payment_providers/manual_capture>或退款<payment_providers/refunds>。
::::
::: seealso
../payment_providers
:::
[SUMMARY]
- Adyen
- 配置概述
- 创建账户并登录
- 开通多部分捕获功能
- 生成 API Key 并复制
- 生成 Client Key 并复制
- 添加允许的来源 URL
- 保存更改
- 创建并配置 Webhook
- 设置服务器 URL 与
/payment/adyen/notification - 生成并复制 HMAC 密钥
- 保存 Webhook 配置
- 复制 API URL 前缀
- Odoo 配置
- 进入 Adyen 支付提供商页面
- 填写 Merchant account、API Key、Client Key、HMAC Key、API URL Prefix
- 设置状态为 Enabled（已启用）
- 测试模式说明：使用测试账户、填写测试 URL 前缀、设为 Test Mode
- 手动捕获
- 在提供商配置中启用 Capture Amount Manually
- 在 Adyen 客户区将 Capture Delay 设置为 Manual
- 注意 7 天未捕获的撤销风险及可在客户区手动捕获/退款
- 配置概述