想象一下这个场景：
你在希腊雅典经营一家精品民宿，旺季时客人络绎不绝。一位德国游客退房时准备刷卡付款，你翻箱倒柜找刷卡机——结果发现机器忘在另一个分店了。客人等得不耐烦，只能尴尬地跑去附近ATM取现金……
这种 "有生意做不了" 的窘境，Viva.com 就是来彻底解决的！
Viva.com是欧洲新兴的支付巨头，它的杀手锏在于：不需要买任何硬件，只要一部带NFC芯片的智能手机，装上viva.com Terminal App，瞬间就能变成一台专业刷卡机！ 当Viva.com遇上Odoo POS，你的收银体验将从"石器时代"直接跃升到 "未来时代" 。
- 零硬件成本：
不需要买刷卡机、不需要IoT盒子，一部手机搞定一切
- 欧洲覆盖广：
支持众多欧洲国家，尤其适合希腊、塞浦路斯、比利时等市场
支持众多欧洲国家，尤其适合希腊、塞浦路斯、比利时等市场
- 手机秒变终端：
任何带NFC的安卓/iPhone都能变成专业支付终端
任何带NFC的安卓/iPhone都能变成专业支付终端
> ⚠️ 重要提示：Odoo目前仅支持欧元（Euro）货币与Viva.com对接。如果你的业务涉及其他货币，需要额外考虑汇率转换方案。
二、准备工作：你需要哪些 "装备" ？
在开始配置之前，请确保以下事项已经准备就绪：
| 装备/信息 | 说明 | 获取方式 |
|---|---|---|
| Viva.com商家账户 | 已注册并验证的Viva.com商户账号 | 前往Viva.com官网注册 |
| 带NFC芯片的智能手机 | 用于安装viva.com Terminal App | 大部分2018年后发布的手机都支持 |
| viva.com Terminal App | 将手机变成刷卡终端的应用 | App Store或Google Play下载 |
| 商户ID、API密钥等 | 连接Odoo所需的关键凭证 | Viva.com后台获取 |
> 小贴士：NFC（近场通信）芯片是手机 "拍卡支付" 的核心硬件。不确定你的手机是否支持？在设置里搜索"NFC"即可查看。
这是整个配置中最关键的部分——从Viva.com后台获取连接Odoo所需的全部凭证。
第一步：登录Viva.com后台获取商户ID和API密钥
- 登录你的Viva.com Dashboard
- 前往 Settings → API Access（设置 → API访问）
- 找到并复制以下两项：
- Merchant ID（商户ID）
- API Key（API密钥）
第二步：获取POS API凭证（Client ID和Client Secret）
- 在同一页面或相关区域
- 找到 POS API credentials（POS API凭证）
- 复制 Client ID（客户端ID）
- 生成并复制 Client Secret（客户端密钥）
> ⚠️ 极度重要警告：POS API凭证（Client ID和Client Secret）只显示一次！一旦页面刷新或关闭，密钥将无法再次查看。务必在生成时立即复制保存到安全的地方！
第三步：在手机上下载并激活viva.com Terminal App
- 在带NFC芯片的智能手机上
- 前往 App Store（iOS） 或 Google Play（Android）
- 搜索并下载 viva.com Terminal 应用
- 打开应用，按照指引完成初始设置
- 生成并复制 Activation Code（激活码）
第四步：在Viva.com后台注册你的 "手机终端"
- 回到Viva.com后台
- 前往 Sales → Card Terminals（销售 → 刷卡终端）
- 点击 创建新终端（Create New Card Terminal）
- 粘贴刚才从手机App获取的 Activation Code（激活码）
- 完成注册
第五步：复制终端ID
- 终端激活成功后，系统会生成一个 Terminal ID（终端ID）
- 复制并保存这个ID
> 现在你已经集齐了五把 "钥匙" ：Merchant ID、API Key、Client ID、Client Secret、Terminal ID。接下来去Odoo里 "开锁" ！
四、Odoo POS配置：七步接入Viva.com
跟着下面十步走，新手也能一次成功。
第一步：在Odoo设置中启用Viva.com终端
- 进入Odoo后台
- 前往 POS → 配置 → 设置
- 向下滚动到 Payment Terminals（支付终端） 区域
- 勾选 Viva.com Terminal
- 点击 保存
第二步：创建新的支付方式
- 进入 POS → 配置 → 支付方式（Payment Methods）
- 点击 创建
第三步：填写基础信息
| 字段 | 填写内容 |
|---|---|
| Method（方式名称） | 可以写"Viva.com"或"刷卡支付" |
| Journal（日记账） | 选择 Bank（银行） |
| Point of Sale（销售点） | 选择你要使用的收银台 |
| Integration（集成方式） | 选择 Terminal（终端） |
| Integrate with（集成对象） | 选择 Viva.com |
第四步：填入Viva.com凭证信息
把前面从Viva.com后台收集到的五把 "钥匙" ，分别粘贴到对应字段：
| 字段 | 填写内容 |
|---|---|
| Merchant ID | Viva.com商户ID |
| API Key | Viva.com API密钥 |
| Client ID | POS API客户端ID |
| Client secret | POS API客户端密钥 |
| Terminal ID | 终端激活后生成的ID |
第五步：保存并获取Webhook URL
- 填写完所有信息后，点击 保存
- 保存后，系统会在 Viva Com Webhook Endpoint 字段中自动生成一个Webhook URL
- 复制这个Webhook URL
> Webhook是什么？简单说就是Viva.com通知Odoo "钱已到账" 的专用通道。没有这个，Odoo就不知道顾客已经付完钱了！
第六步：在Viva.com后台配置Webhook
- 回到Viva.com后台
- 找到Webhook或回调URL配置区域
- 将刚才复制的 Webhook URL 粘贴到对应字段
- 保存设置
第七步：最终保存
- 回到Odoo，确认所有信息无误
- 再次点击 保存
搞定！现在你的收银台已经具备了 "手机秒变刷卡机" 的超能力。🎉
来，感受一下升级后的 "未来感" 流程：
以前：
- 顾客说 "刷卡" ，你翻箱倒柜找笨重的刷卡机
- 机器没电、没网、读卡失败，各种状况频出
- 买一台刷卡机要花几百欧，还要交月租费
- 出门摆摊或开快闪店，刷卡机根本带不走
现在：
- 顾客选好商品，你点击 "收款"
- Odoo POS自动把金额推送到你的手机
- 顾客把手机或信用卡贴近你的手机背面（NFC感应区）
- "滴" 的一声，支付成功！
- Odoo秒级收到Webhook通知，订单自动标记 "已付款"
- 全程不到5秒，顾客惊讶地说 "That's amazing!"
> 创意场景：去市集摆摊？带一部手机就够了。开快闪店？员工各自的手机都能当收银台。开分店？零额外硬件成本，复制粘贴就能搞定！
六、常见问题与避坑指南
| 问题现象 | 可能原因 | 解决办法 |
|---|---|---|
| 无法获取Client Secret | 已经关闭过凭证页面 | 联系Viva.com客服重新生成 |
| 手机NFC感应失败 | 手机NFC未开启或位置不对 | 确认手机设置中NFC已开启，让顾客卡片贴近手机背面顶部 |
| Webhook通知未收到 | Webhook URL配置错误 | 核对Odoo生成的URL与Viva.com后台填写的是否完全一致 |
| 终端显示离线 | 手机未联网或App未登录 | 确保手机网络正常，重新登录viva.com Terminal App |
| 仅支持欧元 | 业务涉及其他货币 | 在Odoo中设置货币转换，或考虑其他支付方案 |
- 零硬件投入：
不需要买刷卡机、不需要IoT盒子，一部手机搞定所有
不需要买刷卡机、不需要IoT盒子，一部手机搞定所有
- 极致便携性：
出门摆摊、快闪店、外卖配送，随时随地都能收款
出门摆摊、快闪店、外卖配送，随时随地都能收款
- 欧洲市场深耕：
支持众多欧洲国家，本地化服务到位
支持众多欧洲国家，本地化服务到位
- 配置简单直观：
五步拿凭证、十步接Odoo，新手也能轻松搞定
五步拿凭证、十步接Odoo，新手也能轻松搞定
- 顾客体验惊艳：
手机拍卡支付，科技感十足，提升品牌形象
手机拍卡支付，科技感十足，提升品牌形象
如果你在希腊、塞浦路斯、比利时或其他欧洲国家经营零售店、餐厅、咖啡馆、民宿或任何需要收款的生意，Viva.com + Odoo POS 的组合，绝对是你降低成本、提升效率、惊艳顾客的 "未来收款方案" ！