连接支付平台
连接你的支付平台，开始追踪收入。
Money Fast 通过 Webhook 接收支付数据。目前支持：Stripe（更多平台即将上线）。
本指南以 Stripe 为例。你可以通过两种方式连接：
方式 A：API Key（推荐）
提供一个 Stripe Restricted Key（受限密钥），Money Fast 会自动创建 Webhook 端点，还能导入你的历史数据。
创建 Restricted Key
- 在仪表盘中前往 添加网站 页面（或已有网站的 设置 > 连接 部分）。
- 点击 在 Stripe 中创建 Restricted Key — 会打开 Stripe 控制台，并预选好所需权限。
- 在 Stripe 中，点击 Create key 生成密钥。
- 复制密钥（以
rk_live_开头），粘贴到 Money Fast 中。
所需权限
受限密钥需要以下权限：
| 资源 | 权限 |
|---|---|
| Charges（收费） | 只读 |
| Customers（客户） | 只读 |
| Invoices（发票） | 只读 |
| Subscriptions（订阅） | 只读 |
| Billing Cadence（账单周期） | 只读 |
| Products（产品） | 只读 |
| PaymentIntents（支付意图） | 只读 |
| Checkout Sessions（结账会话） | 只读 |
| Balance（余额） | 只读 |
| Webhooks | 写入 |
除 Webhooks 需要写入权限（用于自动创建 Webhook 端点）外，其余均为只读权限。Balance 用于获取结算金额、手续费和汇率。
连接后的流程
保存 API Key 后，Money Fast 会：
- 在你的 Stripe 账户中创建一个指向 Money Fast 的 Webhook 端点。
- 安全存储 Webhook 签名密钥。
- 立即开始接收事件。
你还可以 一键导入历史数据。
方式 B：手动 Webhook
如果你不想提供 API Key，可以手动配置 Webhook。
步骤
- 在 Money Fast 中，前往 添加网站 或已有网站的 设置 > 连接 部分。
- 复制页面上显示的 Webhook URL。
- 打开 Stripe 控制台 → 开发者 → Webhooks。
- 点击 添加端点。
- 粘贴 Webhook URL。
- 在 选择事件 中，勾选所有 所需事件。
- API 版本 使用账户默认即可，无需修改。
- 点击 添加端点 完成创建。
- 在端点详情页面，点击签名密钥下的 显示，复制密钥（以
whsec_开头）。 - 将签名密钥粘贴回 Money Fast。
限制
手动 Webhook 方式的限制：
- 只能追踪连接后的 新事件。
- 无法导入历史数据（需要 API Key）。
- 如果 Money Fast 未来支持新的事件类型，你需要手动更新 Webhook 事件列表。
验证连接
连接完成后，你可以验证是否正常工作：
- 在 Money Fast 中进入你的网站 设置 页面。
- 检查 Webhook URL 和签名密钥是否正确显示。
- 在你的网站上进行一笔测试购买。
- 几秒钟内，订单应该出现在 总览 和 事件 页面。
如果事件没有出现，请检查 Stripe Webhook 日志 中的投递错误。
导入历史数据
如果你使用 API Key 方式连接，可以导入支付平台的已有数据：
- 前往网站的 设置 页面。
- 点击 导入 按钮。
- 预览数据摘要（checkout sessions、订阅）。
- 选择要导入的内容，点击 导入。
导入在后台运行。已有记录会自动跳过（去重），因此你可以随时安全地重新导入。