一、Stripe是什么？为什么全球商家都在抢着用它？
想象一下这个场景：
你在美国开了一家精品咖啡店，每天都有来自世界各地的游客光顾。有人想刷Visa，有人想用Apple Pay，还有人掏出一张日本JCB卡……你的老旧的刷卡机只能处理其中几种，剩下的顾客只能尴尬地翻找现金，或者干脆放弃购买转身离开。
这种 "有钱收不了" 的窘境，Stripe 就是来解决这个问题的！
Stripe是全球最知名的支付平台之一，被称为 "开发者的最爱" 。它的 Stripe Terminal 智能读卡器 支持信用卡、借记卡、Apple Pay、Google Pay等几乎所有主流支付方式。当Stripe遇上Odoo POS，你的收银台瞬间变成一个 "全球收款站" ——无需IoT盒子，无需复杂布线，一台小巧的智能读卡器就能搞定一切。
Stripe Terminal 的三大核心优势：
- 无需IoT盒子：
直接连接，省去额外硬件成本和部署麻烦
直接连接，省去额外硬件成本和部署麻烦
- 全球覆盖广：
支持数十个国家的本地支付方式（具体可用国家请查看Stripe Terminal全球可用性列表）
支持数十个国家的本地支付方式（具体可用国家请查看Stripe Terminal全球可用性列表）
- 智能读卡器：
Stripe Terminal smart readers 设计精美、反应灵敏，顾客体验一流
Stripe Terminal smart readers 设计精美、反应灵敏，顾客体验一流
> ⚠️ 重要提示：Stripe终端虽然覆盖很多国家，但并非全球通用。配置前请务必确认你的国家/地区在Stripe Terminal的支持列表中！
二、准备工作：你需要哪些 "装备" ？
在开始配置之前，请确保以下事项已经准备就绪：
| 装备/信息 | 说明 | 获取方式 |
|---|---|---|
| Stripe账户 | 已注册并验证的Stripe商家账户 | 前往Stripe官网注册 |
| Stripe Terminal智能读卡器 | Stripe官方提供的刷卡终端设备 | 在Stripe后台订购 |
| 终端序列号 | 设备底部或Stripe后台可查看 | 设备标签或Stripe Dashboard |
| 稳定的网络环境 | 终端和收银设备需在同一网络下 | 确保WiFi或有线网络正常 |
> 小贴士：终端序列号（Serial Number）通常印在设备底部，也可以登录Stripe后台在设备管理页面查看。
三、Odoo端配置：创建Stripe支付方式
跟着下面几步，在Odoo里搭建好Stripe支付的 "桥梁" 。
第一步：在设置中启用Stripe
- 进入Odoo后台
- 前往 设置（Settings）
- 找到支付相关设置，启用 Stripe 选项
第二步：创建Stripe支付方式
- 进入 POS → 配置 → 支付方式（Payment Methods）
- 点击 创建
第三步：填写支付方式信息
| 字段 | 填写内容 |
|---|---|
| Method（方式名称） | 可以写"Stripe刷卡"或"信用卡支付" |
| Journal（日记账） | 选择 Bank（银行） |
| Use a Payment Terminal（使用支付终端） | 选择 Stripe |
| Stripe Serial Number（Stripe序列号） | 填入你的终端设备序列号 |
> 注意：页面上会有一行蓝色提示文字—— "Don't forget to complete Stripe connect before using this payment method"（别忘了在使用此支付方式前完成Stripe连接）。这个非常重要，我们下一步就来讲！
第四步：关于 "识别客户" 选项
- Identify Customer（识别客户）：勾选后，此支付方式仅限已识别身份的客户使用
- 如果希望任何顾客（包括未注册会员的散客）都能使用Stripe支付，请不要勾选此选项
> 小贴士：Outstanding Account（待清算账户）和 Intermediary Account（中间账户）可以保持为空，Odoo会自动使用默认账户。
四、连接Stripe账户到Odoo：获取API密钥
这是整个配置中最关键的一步——把Odoo和Stripe "牵手成功" 。
第一步：点击 "Connect Stripe"
在支付方式设置页面，点击 Connect Stripe 按钮。系统会自动跳转到一个配置页面。
第二步：填写信息创建/关联Stripe账户
在配置页面中：
- 填写所有必要信息以创建你的Stripe账户
- 或者如果你已有Stripe账户，直接登录关联
- 完成所有表单填写
第三步：获取API密钥
账户关联成功后，你需要从Stripe后台获取两个关键密钥：
| 密钥名称 | 用途 | 获取路径 |
|---|---|---|
| Publishable Key（可发布密钥） | 用于前端展示 | Stripe后台 → Developers → API |
| Secret Key（秘密密钥） | 用于后端验证 | Stripe后台 → Developers → API |
获取方法：
- 在Stripe后台点击 Get your Secret and Publishable keys
- 点击密钥复制
- 粘贴到Odoo对应的字段中
关于API密钥的特别说明
| 使用场景 | 需要的密钥 | 状态设置 |
|---|---|---|
| 仅在POS中使用Stripe终端 | 只需 Secret Key | State可保持 Disabled |
| 将Stripe作为在线支付提供商 | 需要 Publishable Key + Secret Key | State需设为 Enabled |
> 本地部署（On-Premise）特别说明：如果你使用的是本地部署的Odoo数据库，Connect Stripe按钮可能无法正常工作。这时需要手动获取API密钥：
- 登录Stripe后台
- 在搜索栏输入 API
- 点击 Developers → API
- 手动复制密钥粘贴到Odoo
五、配置Stripe支付终端
Odoo这边设置好了，现在来激活你的 "小钢炮" 读卡器。
连接网络
- 在Stripe终端屏幕上向右滑动
- 点击 Settings（设置）
- 输入管理员PIN码（默认：07139）
- 确认后选择你的网络连接方式
> 关键提醒：
- 用户的收银设备和Stripe终端必须连接在同一个网络下
- 如果使用WiFi，网络必须是安全的加密网络（WPA2/WPA3）
- 默认管理员PIN码是 07139，建议配置完成后修改为自定义密码
六、将支付方式绑定到收银台
支付方式创建好了，最后一步把它 "挂" 到你的收银台上：
- 进入 POS → 配置 → 销售点（Point of Sale）
- 选择你要使用的收银台
- 滚动到 Payments（支付） 区域
- 在 Payment Methods（支付方式） 字段中
- 添加刚才创建的Stripe支付方式
- 保存设置
搞定！现在你的收银台已经具备了 "全球收款" 的超能力。🎉
七、常见问题排查：终端在Stripe账户中找不到？
有时候，新购买的终端可能不会自动出现在你的Stripe账户中。这时候需要手动添加：
手动添加终端步骤
第一步：登录Stripe后台
- 登录你的Stripe Dashboard
- 前往 Terminal → 位置（Locations）
第二步：添加或选择位置
- 点击 + New 按钮添加一个新位置（比如 "纽约旗舰店" ）
- 或者选择一个已经创建好的位置
第三步：添加读卡器
- 在 Readers（读卡器）区域点击 + New
- 填写所需信息
第四步：获取注册码
- 在Stripe终端上向右滑动
- 输入管理员PIN码（默认：07139）
- 确认后点击 Generate a registration code（生成注册码）
- 将生成的注册码填入Stripe后台的对应字段
完成以上步骤后，终端就会成功绑定到你的Stripe账户，并在Odoo中正常使用了。
八、使用Stripe终端收款的真实体验
来，感受一下升级后的 "丝滑" 流程：
以前：
- 顾客掏出信用卡，你拿出笨重的刷卡机
- 插卡、输密码、等授权，偶尔还读卡失败
- 支持Apple Pay？不支持。Google Pay？不支持。
- 外国游客的卡刷不了，只能尴尬地说Sorry
现在：
- 顾客选好商品，你点击 "收款"
- Odoo POS自动把金额推送到Stripe智能读卡器
- 顾客在读卡器上刷卡、插卡、拍卡（非接触支付）或使用手机钱包
- 终端秒级处理，Odoo自动收到付款成功通知
- 订单状态自动更新，小票自动打印
- 全程不到10秒，顾客笑着说 "That was fast!"
九、总结：为什么Stripe + Odoo POS是商家的 "全球化收款神器" ？
- 零额外硬件：
无需IoT盒子，一台Stripe Terminal智能读卡器即插即用
无需IoT盒子，一台Stripe Terminal智能读卡器即插即用
- 支付方式全覆盖：
信用卡、借记卡、Apple Pay、Google Pay通吃
信用卡、借记卡、Apple Pay、Google Pay通吃
- 全球业务友好：
支持数十个国家，适合有国际客户的商家
支持数十个国家，适合有国际客户的商家
- 配置简单直观：
API密钥一键连接，新手也能轻松搞定
API密钥一键连接，新手也能轻松搞定
- 顾客体验一流：
sleek设计、快速响应，提升品牌形象
sleek设计、快速响应，提升品牌形象
如果你经营的是面向国际客户的零售店、餐厅、咖啡馆或任何需要收款的生意，Stripe + Odoo POS 的组合，绝对是你走向全球化、提升收款效率的 "最佳拍档" ！