目录
article
Adyen 支付终端集成指南 – Odoo POS 配置与使用
Adyen
连接 Adyen 支付终端 可为客户提供流畅的支付流程,并减轻收银员的工作负担。
:::: important ::: title 重要信息 :::
- Adyen 支付终端 不需要
IoT Box </applications/general/iot>。 - Adyen 终端可在多个国家使用,但并非全球通用。请查看 Adyen 支持的国家列表。
- Adyen 仅适用于年处理额超过 1000 万美元 或每月至少 1000 笔交易 的企业。
::::
::: seealso
配置
首先在 Adyen 官方网站 创建 Adyen 账户。随后按照终端屏幕上显示的步骤完成终端的激活。
::: seealso Adyen 文档 – 支付终端快速入门指南
:::
生成 Adyen API 密钥 {#adyen/api}
Adyen API 密钥 用于对来自 Adyen 终端的请求进行身份验证。生成方法如下:
- 进入
Adyen 账户 --> 开发者 --> API 凭证。 - 创建 新凭证或选择 已有 凭证。
- 点击 生成 API 密钥,将得到的密钥保存,并在 Odoo 中的
Adyen API 密钥字段(位于支付方式创建 <adyen/method-creation>)中粘贴。
::: seealso
获取 Adyen 终端标识符 {#adyen/identifier}
Adyen 终端标识符 是终端的序列号,用于唯一识别硬件。
获取步骤:
- 进入
Adyen 账户 --> 销售点 --> 终端。 - 选中需要关联的终端,记录其序列号。
- 将该序列号粘贴到 Odoo 中
Adyen 终端标识符字段(同样位于支付方式创建 <adyen/method-creation>)。
配置事件 URL
为了让 Odoo 能够接收到支付完成的通知,需要配置终端的 事件 URL,步骤如下:
- 登录 Adyen 网站;
- 前往
Adyen 仪表盘 --> 销售点 --> 终端,选择已连接的终端; - 在终端设置中点击 集成 (Integrations);
- 将
Switch to decrypted mode to edit this setting设为 Decrypted; - 点击 铅笔图标,在
Event URLs字段中输入服务器地址并追加/pos_adyen/notification; - 在页面底部点击 保存。
配置支付方式 {#adyen/method-creation}
- 在 应用设置 <configuration/settings> 中启用支付终端;
- 创建对应的 支付方式 <../../payment_methods>,将日记账类型设为 Bank,在 使用支付终端 字段选择 Adyen;
- 填写必填项:
Adyen API 密钥 <adyen/api>、Adyen 终端标识符 <adyen/identifier>与Adyen 商户账户。
支付方式创建完成后,可在 POS 设置中选择该方式:
- 进入
POS 设置 <configuration/settings>,点击 编辑; - 在 支付 (Payments) 区域添加刚才创建的支付方式。
小贴士 {#adyen/tips}
Odoo POS 支持使用 Adyen 终端收取小费。配置方法:
- 在
POS 设置 <configuration/settings>中启用 小费 <pos/restaurant/tips> 与 通过支付终端(Adyen)添加小费; - 保存设置。
使用 Adyen 终端收取小费的操作流程:
- 前往对应的 POS 并 处理订单 <pos/restaurant/orders>;
- 点击 支付 <pos/restaurant/bills/payment>,选择 相应的支付方式 <adyen/method-creation>;终端会显示交易并提示添加小费;
- 在终端上输入小费金额并确认;
- 在 Odoo POS 中点击 ❤️ Tip,输入小费金额后点击 确定;
- 点击 关闭标签页 完成支付和小费的确认。