本篇要点
位置： 设置 → 读者与收入 → 关联 → 支付
打开此页面： admin.<your-site>/settings/connections/payments（将 <your-site> 替换为您的网站地址）
开始之前
- 请先绑定 Razorpay、Stripe 或 PayPal。请参阅 Payments。
- 您必须是网站所有者。
操作步骤
Stripe 和 PayPal： Keynate 会尽可能自动为您在账户中配置好支付通知。卡片上会显示“已为您在 Stripe 中配置好支付通知”。如果无法自动完成，则会显示“还差一步”和 完成设置 按钮。请按照以下步骤操作。
Razorpay： 无法自动配置。Razorpay 卡片提供了一个引导式的 3 步操作框并支持实时检测：在您完成第一笔测试或真实付款后，Waiting for Razorpay's first message… 会变为 We received Razorpay's first message.。点击 立即检查 即可重新检查。请参阅 Connect Razorpay。
适用于所有网关的设置步骤：
- 打开 设置 → 读者与收益 → 关联与集成 → 支付。
- 在对应的网关卡片中，找到 Webhook 区域。
- 点击 Open webhooks（按钮会显示具体网关名称）。网关的管理后台将在新标签页中打开。
- 在网关后台中，点击 添加。
- 返回 Keynate，点击 Webhook URL 旁的 复制，并将其粘贴到网关后台中。
- 勾选 Keynate 提示框中列出的所有事件。
- Razorpay：点击密钥上的 复制 并将其粘贴为 Secret。请为测试模式和正式模式使用不同的密钥。
- 在网关中保存设置。
- 保存后，Stripe 和 PayPal 会显示一串代码。Stripe 称其为签名密钥（Signing Secret），以
whsec_开头；PayPal 称其为 Webhook ID。将其复制并粘贴到 Keynate 的对应输入框中。 - 点击 测试连接。
温馨提示
- 测试模式和正式模式分别需要配置各自独立的 Webhook。
- 如果丢失了密钥，请在网关中添加一个新的 Webhook，并将新代码粘贴到 Keynate。
常见故障
- "Paste the webhook secret you typed in Razorpay." Keynate 中的输入框为空。请粘贴您在 Razorpay 中填写的相同密钥。
- "Use a different webhook secret for test and live." 请为第二种模式生成一个新的密钥。
- "Paste the webhook signing secret. It starts with whsec_." 添加端点后，从 Stripe 后台复制该签名密钥。
- "Paste the Webhook ID (letters and numbers only)." 从 PayPal 应用的 Webhooks 列表中复制该 ID。
- Razorpay 依然显示 "Waiting for Razorpay's first message…"。 请发起一笔小额测试付款。通知消息会在首次付款后送达。随后点击 立即检查。
- 读者付款后订单仍显示未支付。 Webhook 可能未配置或填写有误。每天夜间，Keynate 也会自动比对您的订单与支付网关数据，补录漏掉的订单。
常见问题
常见问题
这和 API 密钥是一回事吗？
不是。API 密钥用于让 Keynate 主动调用网关，而 Webhook 是让网关主动通知 Keynate。
测试模式和正式模式都需要配置 Webhook 吗？
是的。测试模式和正式模式各自都需要单独配置。
如果密钥弄丢了怎么办？
直接在网关后台新建一个 Webhook，然后把新的代码复制粘贴到 Keynate 即可。
如果读者明明付了款，订单却一直显示未支付怎么办？
通常是 Webhook 缺失或配置错误。Keynate 每晚都会自动将订单与支付网关进行对账核实，自动修复遗漏的付款记录。