Setup

支付(Stripe)

使用你自己的 Stripe 账户(BYO 模式),在报价单上生成支付链接。

支付集成使用的是你自己的 Stripe 账户(BYO 模式:自带账户)。付款会直接进入你的 Stripe 账户:我们这边不产生任何费用、加价或中间环节。我们只负责打通相关字段以及生成链接的按钮。

该集成默认处于未启用状态:在你粘贴密钥并激活之前,不会有任何操作。密钥会以加密方式存储在 CRM 中,不会再次显示。

前提条件

拥有一个有效的 Stripe 账户(要进行真实收款,该账户在你所在国家/地区必须已启用支付功能)。
可以访问 Stripe 控制台,并拥有查看 API 密钥(Developers → API keys)和创建 webhook(Developers → Webhooks)的权限。
在 Sellio 中拥有管理员权限,以便在“设置 → 集成”中保存密钥并激活该集成。

Secret key(密钥):在 Stripe 控制台的 Developers → API keys 中获取(生产环境以 sk_live_ 开头,测试环境以 sk_test_ 开头)。
Webhook signing secret(webhook 签名密钥,初期可选):在 Stripe 中创建 webhook 时生成(以 whsec_ 开头)。它是自动确认付款的关键。

打开“设置 → 集成”,找到“支付(Stripe)”卡片。
粘贴你的 Stripe secret key,点击“保存密钥”。
复制出现的“Stripe webhook URL”,然后在 Stripe 控制台(Developers → Webhooks)中为该 URL 创建一个端点,勾选事件 checkout.session.completed 和 payment_intent.succeeded。
返回 CRM,将 webhook signing secret(whsec_...)与 secret key 一起粘贴并再次保存。
点击“激活”。

💡 如果在未配置 Stripe 的情况下尝试生成链接,CRM 会明确提示你,且不会产生任何收费。该功能在密钥配置完成之前始终处于未启用状态。当与某报价单关联的付款被确认后,该报价单会自动被标记为“已接受”。

请将 webhook URL 视为机密信息;更改密钥时请始终将两个密钥一起粘贴(出于安全考虑,CRM 不会再次显示已保存的密钥)。

使用测试密钥(测试模式下的 sk_test_.../whsec_),以免产生真实收费。
在某个报价单上生成一个“支付链接”并打开它:你应该会跳转到 Stripe 的结账页面,金额为该报价单的总金额。
使用 Stripe 测试卡付款(例如 4242 4242 4242 4242)。确认该报价单变为“已付款”并被标记为“已接受”,这表明 webhook 已到达且签名校验通过。
在 Stripe 控制台(Developers → Webhooks → 你的端点)中,查看已投递事件的历史记录以及 200 状态码。

生成链接时出错 / Stripe 返回 401:secret key 有误,或来自错误的模式(你粘贴的是测试密钥但环境是生产环境,反之亦然)。请重新粘贴正确的 sk_ 密钥。
客户已付款,但报价单没有变为“已付款”:webhook 没有正常确认。请检查你是否在 Stripe 中创建了指向“Stripe webhook URL”的端点,并勾选了事件 checkout.session.completed 和 payment_intent.succeeded。
webhook 签名无效:CRM 中的 webhook signing secret(whsec_...)与 Stripe 端点的密钥不一致。请复制该端点的密钥,并与 secret key 一起粘贴(两者需一起保存)。
webhook URL 返回 404:集成未激活,或 URL 令牌已更改。请重新激活并将新的 URL 重新复制到 Stripe。
点击生成链接后没有任何反应:该集成因缺少密钥而处于未启用状态。请先粘贴 secret key 并激活。