# 在 Odoo 20.0 安装 Paymos 收款插件

> 在自托管的 Odoo 20.0 安装 Paymos，绑定收款项目，先用沙盒订单核对付款结果，再开启正式收款。

买家在 Odoo 下单，跳转到 Paymos 付款页付款。回到 Odoo 后，可以在订单里查看付款结果。

## 安装前需要什么

插件免费，采用 LGPL-3.0-only 许可证。需要自托管的 Odoo 20.0、可通过 HTTPS 访问的网店，以及 `payment`、`account_payment` 和 `website_sale` 模块。插件已用 Python 3.12 验证。Odoo Online 无法安装，Odoo.sh 尚未测试。

先在 Paymos 准备好账号和收款项目，再以系统管理员身份进入 Odoo 中网店所属的公司。为这家公司准备银行日记账，并确认日记账的入账方式中有 Paymos。

## 安装插件

如果 [GitHub Releases](https://github.com/Paymos-labs/odoo/releases/latest) 已发布 ZIP 安装包，请先下载。是否已上架 Odoo Apps，需另行查看。把 `payment_paymos/` 和 `requirements.txt` 解压到 `addons_path` 中的一个目录。进入该目录，用 Odoo 服务所用的 Python 执行下列命令，并把 `/path/to/wheels` 换成预先备好的 wheel 包目录。

```bash
python -m pip install --no-index --find-links /path/to/wheels --require-hashes -r requirements.txt
```

文件为低于 3.13 的 Python 固定了 `typing-extensions` 的版本。把自己的 Fernet 密钥存入受保护的服务配置，名称设为 `PAYMOS_ODOO_ENVELOPE_KEY`。重启 Odoo，更新应用列表，再安装 **Paymos Payments**。

## 绑定项目并试下一单

打开 **Payment Providers** 中的 **Paymos**，点击 **Connect Paymos**。授权访问收款项目，再选银行日记账。在 **Sandbox** 中启用并发布付款方式，到网店下一单，然后回 Odoo 核对付款结果。准备正式收款时，点击 **Select Live**，核对日记账，再重新启用并发布付款方式。

## 订单什么时候确认

Odoo 通过 API 创建账单时，只发送项目 ID、订单总额、币种和不含业务信息的订单编号。请求里没有买家的身份资料。

插件先核验通知的 HMAC 签名，再通过 API 核对付款记录。只有金额付足且记录相符，订单才会确认一次。少付、逾期或记录不符都不会确认订单。没收到通知时，定时任务会通过 API 补查付款状态，查询次数有上限。

## 退回原款或多付款

要全额退款，在 Odoo 会计模块打开付款记录，点击 **Refund**，输入与原付款完全相同的金额。只退多付的部分时，打开付款交易，点击 **Refund Paymos overpayment**。退款金额由 Paymos 计算，款项退给记录中的付款人。处理期间，Odoo 里的退款会保持待处理。各退款状态的含义见[退款指南](/zh-hans/docs/support/refunds.md)。
