本页内容
在 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 已发布 ZIP 安装包,请先下载。是否已上架 Odoo Apps,需另行查看。把 payment_paymos/ 和 requirements.txt 解压到 addons_path 中的一个目录。进入该目录,用 Odoo 服务所用的 Python 执行下列命令,并把 /path/to/wheels 换成预先备好的 wheel 包目录。
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 里的退款会保持待处理。各退款状态的含义见退款指南。