一、什么是QFPay？为什么香港商家都在用它？
想象一下这个画面：
顾客买完东西，掏出手机准备扫码付款。你手忙脚乱地翻找收款码，结果顾客等得不耐烦，转身走了……
这种尴尬，相信不少香港商家都经历过。
QFPay（钱方支付）就是来解决这个问题的！它是专为香港市场打造的支付服务，通过 HaoJin App（好近App） 配合实体支付终端，让顾客刷卡、扫码都能一气呵成。
QFPay的三大亮点：
- 无需IoT Box：不用额外购买硬件盒子，直接就能连上Odoo POS，省钱又省心
- 专为香港设计：本地化服务，支持香港主流支付方式
- 异步通知秒到账：付款成功或退款完成，系统会自动推送确认消息，你再也不用盯着屏幕傻等了
> 注意：QFPay终端目前仅限香港地区使用哦！
二、QFPay终端配置：六步走，轻松搞定
想把QFPay接进你的Odoo POS？跟着这六步走，新手也能一次成功！
第一步：注册QFPay账号
- 前往QFPay官网
- 按照指引完成商家注册
- 拿到你的商户账号
第二步：申请开通异步通知
这一步非常关键！你需要联系QFPay客服，申请开通 Asynchronous Notifications（异步通知） 功能。
什么是异步通知？简单说就是：顾客付完钱后，QFPay会自动发一条"付款成功"或"退款完成"的消息给你的系统，完全不用人工确认。
第三步：配置服务器地址，获取通知密钥
- 把你的Odoo服务器地址提供给QFPay
- 地址格式必须是：`https://你的域名.odoo.com/qfpay/notify`
- QFPay会给你一个 Notification Key（通知密钥），务必复制保存好！
> 小贴士：这个密钥就像你家门的密码，丢了就得重新申请，一定要保管好！
第四步：绑定终端，获取IP地址
- 按照QFPay的指引，将 HaoJin App 连接到你的QFPay账户
- 连接成功后，记下终端的 IP地址
> 重要提醒：如果终端IP地址变了，记得及时在Odoo POS设置里更新，并重新向QFPay申请自签名证书！
第五步：导入自签名证书
- 向QFPay申请一份与你终端IP地址绑定的 自签名证书（Self-signed Certificate）
- 将证书导入到你的POS收银机中
这一步是为了确保支付数据传输的安全性，就像给你们的 "通话" 加了一把密码锁。
第六步：生成POS-KEY
- 打开 HaoJin App
- 进入设置界面，找到生成POS-KEY的选项
- 点击生成，复制保存好这个密钥
> 如果你已经有QFPay账户，直接发邮件到 `technical.support@qfpay.com`，附上你的商户信息和服务器地址，客服会帮你搞定后续配置。
三、Odoo POS配置：把QFPay"装"进你的收银台
QFPay那边设置好了，接下来就是在Odoo POS里 "对接" 了。跟着下面七步走：
第一步：开启QFPay终端功能
- 进入 Odoo 后台
- 找到 POS设置
- 滚动到 Payment Terminals（支付终端）区域
- 勾选 QFPay Terminal
- 点击 保存
第二步：创建新的支付方式
- 进入 POS → 配置 → 支付方式
- 点击 创建
第三步：填写基础信息
| 字段 | 填写内容 |
|---|---|
| Journal（日记账） | 选择 Bank（银行） |
| Point of Sale（销售点） | 选择你要使用的收银台 |
| Integration（集成方式） | 选择 Terminal（终端） |
| Integrate with（集成对象） | 选择 QFPay |
第四步：填入QFPay提供的密钥信息
把前面从QFPay复制好的三个关键信息，分别粘贴到对应字段：
- Terminal IP：终端IP地址
- POS Key：从HaoJin App生成的POS-KEY
- Notification Key：从QFPay获取的通知密钥
全部填完，保存！🎉
四、配置完成后，你的收银体验会变成什么样？
来，感受一下 "升级后" 的流畅体验：
以前：
- 顾客掏出信用卡，你翻箱倒柜找刷卡机
- 刷完卡还要手动在系统里点"已收款"
- 偶尔输错金额，对账对到怀疑人生
现在：
- 顾客说 "刷卡" ，你淡定地在Odoo POS界面选择QFPay支付方式
- 金额自动同步到QFPay终端
- 顾客在终端上刷卡/扫码，付款成功
- Odoo自动收到异步通知，订单状态秒变 "已付款"
- 你微笑着说 "谢谢光临" ，全程不超过10秒
五、常见问题与避坑指南
| 问题 | 原因 | 解决办法 |
|---|---|---|
| 支付状态没更新 | 异步通知没开通 | 联系QFPay开通Asynchronous Notifications |
| 连接失败 | 终端IP变了 | 更新IP地址，重新申请自签名证书 |
| 找不到QFPay选项 | POS设置里没开启 | 回到POS设置，勾选QFPay Terminal |
| 证书导入失败 | 证书与IP不匹配 | 确保证书绑定的IP与当前终端IP一致 |
六、总结：为什么香港商家值得接入QFPay？
- 本地化服务：专为香港市场优化，支付方式贴合本地习惯
- 零额外硬件：不需要IoT Box，降低部署成本
- 自动化对账：异步通知让每笔交易状态实时同步，告别手动核对
- 顾客体验升级：付款速度快，排队时间缩短，回头客自然多
如果你在香港经营零售店、餐厅或任何需要收款的生意，QFPay + Odoo POS 的组合，绝对是你提升效率、留住顾客的 "秘密武器" ！