集成
连接 Stripe
客户通过您的 Stripe 账户在线支付发票；VentionDesk 入账付款。
在哪里连接
在 VentionDesk 中的运维 › 来源 › “添加来源”，类别选择支付，然后选择Stripe。只有所有者可以连接、编辑和移除。
分步说明
- 在 Stripe 的 Developers › API keys 下创建一个受限密钥“VentionDesk”。它恰好需要以下权限，其余全部保持“None”：Checkout Sessions：Write（创建付款页面）; PaymentIntents：Read（退款前检查还有哪些未付）; Charges：Read（读取已在该处退款的金额）; Refunds：Write（从 VentionDesk 发起退款）。
- 在这里填写密钥并保存。VentionDesk 通过查询 checkout sessions 检查密钥；不会产生任何扣款。允许使用测试密钥（rk_test_…）：此时发票上只有测试链接，邮件和发票凭证中不含链接。
- 然后在“来源” › Stripe 下点击“显示 Webhook 地址”，并在 Stripe 的 Developers › Webhooks › “Add endpoint”中添加该地址，事件恰好为：checkout.session.completed、checkout.session.async_payment_succeeded、checkout.session.async_payment_failed、charge.refunded。
- 复制该端点的“Signing secret”（whsec_…），然后使用密钥和签名密钥再次保存连接。只有这样，付款链接才会出现在发票邮件和凭证中：没有 Webhook 时，付款到账后 VentionDesk 不会入账。
- 款项进入您的 Stripe 账户。VentionDesk 将每笔付款和每笔退款记入对应发票，并且只向 Stripe 发送发票编号、金额和客户的电子邮件地址。
对话框需要填写的内容
| 字段 | 填写内容 | 来源 |
|---|---|---|
| 受限密钥 | 必填 | 机密 | Developers › API keys › “Create restricted key”（rk_live_… 或 rk_test_…）。Secret key（sk_…）也可以使用，但它拥有全部权限。 |
| Webhook 签名密钥 | 可选 | 机密 | 创建端点后显示在 Developers › Webhooks › 您的端点 › “Signing secret”下（whsec_…）。留空则保留之前的值。 |
VentionDesk 加密存储机密信息，且不会再次显示。只有在服务商确认访问后才会保存；编辑连接时如果机密字段留空，则保留原有值。