Stripe 将线上订单的银行卡付款直接收入一个 Stripe 账户，即该集成所用密钥所属的账户，通常是餐厅自己的账户。Stripe 再将款项打到该账户绑定的银行账户。OrderTiger 不在 Stripe 中收取任何费用；OrderTiger 的各项收费会单独列在餐厅的发票上。
如果要在 Stripe 中从每笔付款里抽取一部分，或代餐厅收款，请改用 Stripe Connect。
设置方法#
- 在公司视图中，打开财务 → 支付集成，点击 Stripe 卡片上的 +。
- 在表单顶部保持选择 Stripe（不要选 Stripe Connect）。
- 填写下列字段，然后点击保存。
- 在门店视图中，打开财务 → 付款方式，添加或编辑银行卡付款方式，并选择此集成作为其支付处理方。
| 字段 | 说明 |
|---|---|
| 标识符名称 | 您为该集成取的名称，显示在列表中，在付款方式中选择集成时也会看到。 |
| 公钥 | Stripe 的可发布密钥（pk_live_… 或 pk_test_…），在 Stripe 的开发人员 → API 密钥中获取。 |
| 密钥 | 同一账户的 Stripe 密钥（sk_live_… 或 sk_test_…）。默认隐藏，点击眼睛图标即可显示。 |
| Webhook 签名密钥 | 可选。留空即可：保存时，OrderTiger 会在此 Stripe 账户上创建自己的 webhook，并自动为您填入。 |
| 自动结算付款 | 开启：顾客一付款就从银行卡扣款。关闭：只在银行卡上冻结该金额，订单被接受时才扣款。自动确认订单的门店始终立即扣款。 |
| Apple Pay / Google Pay | 在结账时提供这些电子钱包。Apple Pay 还需要在 Stripe 中验证域名。 |
| iOS 商户 ID | iOS 点餐应用使用的 Apple Pay 商户 ID。仅超级管理员可见。 |
银行卡订单如何标记为已付款#
顾客付款后，订单会处于银行卡待付款状态，直到 Stripe 确认付款。Stripe 通过调用 OrderTiger 的 webhook 来确认；随后订单变为已付款，并出现在实时订单中。
- 保存集成时，系统会自动在该 Stripe 账户上创建 webhook，监听
charge.succeeded事件。您可以在 Stripe 的开发人员 → Webhook 中看到它。 - 它的签名密钥保存在Webhook 签名密钥中。保存了签名密钥后，OrderTiger 只接受带有 Stripe 签名的付款确认；没有保存时，付款确认不经此校验即被接受。
- 如果保存时该 webhook 已经存在，系统会沿用它，此字段则保持为空：Stripe 只在创建 webhook 时提供其签名密钥。请在 Stripe 中从该 webhook 复制签名密钥（显示）并粘贴到此处，或在 Stripe 中删除该 webhook 后重新保存集成。
退款#
退款在订单中操作，使用订单上的退款按钮。退款从当初收款的同一个 Stripe 账户中扣出，退回到顾客的银行卡。
- 没有需要分摊的费用：全部退款都从该账户扣出。
- 退款时，Stripe 不会退还其银行卡手续费。
- 对于门户类公司的订单，退款表单会询问商家是否需要对这笔退款承担责任？。使用普通 Stripe 时，款项始终从此 Stripe 账户中扣出；该回答只决定退款在发票上如何显示：商家承担的退款会从餐厅收入中扣除，平台承担的退款则不会。
- 可以部分退款；已退的金额会列在订单下方。
故障排除#
| 问题 | 检查事项 |
|---|---|
| 已付款的订单一直停留在银行卡待付款状态，始终没有进入实时订单 | Stripe 的确认没有送达。请在 Stripe 中检查开发人员 → Webhook 下是否有 OrderTiger 的 webhook，并查看它最近的推送记录。如果没有，请重新保存集成来创建它。 |
| 保存后Webhook 签名密钥仍为空 | 该 webhook 之前已经存在。请从 Stripe 复制其签名密钥粘贴进来，或在 Stripe 中删除该 webhook 后重新保存。 |
| 付款失败，提示身份验证错误 | 密钥和公钥必须来自同一个 Stripe 账户，并且是同一种模式（都是测试或都是正式）。 |