一、Worldline是什么？为什么比荷卢商家都在用它？
想象一下这个场景：
在比利时布鲁塞尔的一家巧克力店里，一位荷兰游客挑好了一盒手工巧克力，走到收银台准备刷卡。收银员拿出一台老旧的刷卡机，插卡、输密码、等授权……结果机器显示"连接失败"，顾客只能尴尬地翻找现金，或者干脆放弃购买。
这种 "有钱收不了" 的窘境，在比利时、荷兰、卢森堡（比荷卢地区）做生意的老板们一定不陌生。
Worldline 就是来解决这个问题的！它是欧洲最大的支付服务提供商之一，尤其在比荷卢地区拥有极高的市场占有率。当Worldline遇上Odoo POS，你的收银台就变成了一个 "欧洲本地收款专家" ——支持所有欧洲主流银行卡，通过IoT系统实现终端与Odoo的无缝对接。
Worldline终端的三大核心优势：
- 比荷卢地区王者：
深耕比利时、荷兰、卢森堡市场多年，本地化服务无可挑剔
深耕比利时、荷兰、卢森堡市场多年，本地化服务无可挑剔
- CTEP协议兼容：
Odoo完美支持使用CTEP协议的Worldline终端（如Yomani XR和Yoximo）
Odoo完美支持使用CTEP协议的Worldline终端（如Yomani XR和Yoximo）
- IoT智能连接：
通过IoT盒子或虚拟IoT实现终端与Odoo的实时通信
通过IoT盒子或虚拟IoT实现终端与Odoo的实时通信
> ⚠️ 重要提示：Worldline目前仅支持比利时、荷兰、卢森堡三个国家。如果你在其他地区，可以考虑Stripe、SIX等其他支付方案。
二、准备工作：你需要哪些 "装备" ？
在开始配置之前，请确保以下事项已经准备就绪：
| 装备/信息 | 说明 | 获取方式 |
|---|---|---|
| Worldline CTEP终端 | 支持CTEP协议的Yomani XR或Yoximo终端 | 向Worldline或授权经销商购买 |
| IoT系统 | 树莓派IoT盒子或Windows虚拟IoT | 自行搭建或购买Odoo官方IoT盒子 |
| IoT IP地址 | IoT系统在网络中的IP地址 | 路由器后台或IoT设备查看 |
| 稳定的网络环境 | 终端和IoT必须在同一网络下 | 确保店铺WiFi或有线网络正常 |
> 小贴士：购买终端前务必确认型号支持CTEP协议。如果不确定，联系Worldline客服或供应商确认兼容性。
三、Worldline终端配置：三步激活CTEP协议
这是整个配置中最关键的部分——在终端上设置好 "与Odoo对话的语言" 。
第一步：配置ECR协议
- 在Worldline终端上，按下 F键
- 输入技术员密码：1235789
- 按 OK 确认
- 依次按下以下按键组合，每步按 OK 确认：
- CTEP ticket ECR
- ECR ticket width
- Character set
- 按 Stop 键三次，终端会自动重启
> ECR（Electronic Cash Register）协议是终端与收银系统通信的 "语言" 。CTEP是Worldline专门为这种对接设计的协议版本。
第二步：设置主机名（Hostname）
- 终端重启后，再次按下 F键
- 输入技术员密码：1235789
- 按 OK 确认
- 按对应按键进入主机名设置，按 OK 两次
- 在 Hostname 屏幕上，输入你的 IoT IP地址
- 每输入一个数字后按 OK 确认，遇到冒号符号时也按 OK
- 例如：如果IoT地址是 `10.30.19.4:8069`，就依次按 1 → OK → 0 → OK → . → OK → 3 → OK → 0 → OK → . → OK → 1 → OK → 9 → OK → . → OK → 4 → OK → : → OK → 8 → OK → 0 → OK → 6 → OK → 9 → OK
第三步：设置端口号
- 在 Network domain name 屏幕上：
- 如果使用 IoT盒子（树莓派），输入：9001
- 如果使用 Windows虚拟IoT，输入：9050
- 按 OK 两次确认
- 按 Stop 键三次，终端再次自动重启
终端重启完成后，屏幕上会显示 Read card（请刷卡），表示终端已激活并准备就绪！
> 检查连接状态小贴士：打开Odoo的IoT应用，点击IoT系统的卡片，可以查看终端的连接状态是否正常。
四、Odoo POS配置：四步接入Worldline
终端设置好了，现在来Odoo里 "搭积木" 。
第一步：在POS设置中启用Worldline终端
- 进入Odoo后台
- 前往 POS → 配置 → 设置
- 在 Payment Terminals（支付终端） 区域
- 勾选 Worldline
- 点击 保存
第二步：创建Worldline支付方式
- 进入 POS → 配置 → 支付方式（Payment Methods）
- 点击 创建
第三步：填写基础信息
| 字段 | 填写内容 |
|---|---|
| Method（方式名称） | 可以写 "Worldline刷卡" 或 "银行卡支付" |
| Journal（日记账） | 选择 Bank（银行） |
| Integration（集成方式） | 选择 Terminal（终端） |
| Integrate with（集成对象） | 选择 Worldline |
| Payment Terminal Device（支付终端设备） | 从下拉菜单中选择已配置的终端设备 |
- 填写完成后，点击 保存
第四步：将支付方式绑定到收银台
- 进入 POS → 配置 → 销售点（Point of Sale）
- 选择你要使用的收银台
- 在 Payment（支付） 区域的 Payment Methods（支付方式） 字段中
- 添加刚才创建的Worldline支付方式
- 点击 保存
搞定！现在你的收银台已经具备了 "欧洲本地秒收" 的超能力。🎉
五、使用Worldline终端收款的真实体验
来，感受一下升级后的 "丝滑" 流程：
以前：
- 顾客说 "我刷卡" ，你拿出独立的刷卡机
- 手动输入金额，生怕按错一个零
- 刷完卡还要在Odoo里手动点 "已收款"
- 偶尔网络卡顿，交易状态不明，对账对到怀疑人生
现在：
- 顾客选好商品，你点击 "收款"
- Odoo POS自动把金额推送到Worldline终端
- 顾客在终端上刷卡、插卡或非接触式拍卡
- 终端秒级处理，Odoo自动收到付款成功通知
- 订单自动标记 "已付款" ，小票自动打印
- 全程不到10秒，顾客微笑着说 "Dank u wel!"
六、进阶技巧与避坑指南
| 技巧/注意事项 | 说明 |
|---|---|
| 分离式终端配置 | 如果同时使用收银员终端和顾客自助终端，先配置收银员终端 |
| 固定IP地址 | 为防止IoT盒子IP变动导致连接中断，建议在路由器中为IoT设置固定IP |
| 虚拟IoT重启 | 如果使用Windows虚拟IoT，定期重启服务器可防止连接丢失 |
| 技术员密码 | 默认密码是 1235789，建议配置完成后修改为自定义密码 |
| 终端型号确认 | 购买前务必确认终端支持CTEP协议，Yomani XR和Yoximo是已知兼容型号 |
七、常见问题排查
| 问题现象 | 可能原因 | 解决办法 |
|---|---|---|
| 终端显示"连接失败" | IoT IP地址输入错误 | 核对IoT系统的实际IP地址，重新配置Hostname |
| 交易无响应 | 端口号设置错误 | 确认使用的是9001（IoT盒子）还是9050（虚拟IoT） |
| Odoo找不到终端设备 | IoT系统未正确连接 | 检查IoT应用中的连接状态，确保终端和IoT在同一网络 |
| 刷卡后Odoo未更新 | Webhook或通信中断 | 重启终端和IoT系统，检查网络稳定性 |
| 小票打印异常 | ECR协议配置不完整 | 重新配置CTEP ticket ECR、ECR ticket width和Character set |
八、总结：为什么Worldline + Odoo POS是比荷卢商家的 "欧洲收款王牌" ？
- 比荷卢地区深耕：
Worldline在比利时、荷兰、卢森堡拥有极高的银行卡受理覆盖率
Worldline在比利时、荷兰、卢森堡拥有极高的银行卡受理覆盖率
- CTEP协议稳定：
专为收银系统对接设计的通信协议，稳定可靠
专为收银系统对接设计的通信协议，稳定可靠
- IoT智能桥梁：
树莓派或虚拟IoT作为 "中间人" ，让终端与Odoo无缝对话
树莓派或虚拟IoT作为 "中间人" ，让终端与Odoo无缝对话
- 收银效率飙升：
金额自动推送，无需手动输入，错误率归零
金额自动推送，无需手动输入，错误率归零
- 对账轻松愉快：
每笔交易状态实时回传，财务报表自动生成
每笔交易状态实时回传，财务报表自动生成
如果你在比利时、荷兰或卢森堡经营零售店、餐厅、咖啡馆、酒店或任何需要收款的生意，Worldline + Odoo POS + IoT系统的组合，绝对是你提升效率、赢得顾客信赖的 "欧洲收款王牌" ！