n8n 中文文档

Stripe 凭证

您可以使用这些凭据来验证以下节点:

支持的认证方式

  • 秘钥

n8n 强烈建议还设置 签名密钥(有时称为端点密钥),这是每个 Webhook 端点的唯一密钥。这允许 Stripe触发器 节点验证传入请求是否真正来自 Stripe。有关设置步骤,请参阅 验证传入的请求。

相关资源

要配置此凭据,您需要 Stripe 管理员或开发人员帐户。有关该服务的更多信息,请参阅 Stripe 的 API 文档。

在生成 API 密钥之前,请决定是在实时模式还是测试模式下生成。有关这两种模式的更多信息,请参阅 测试模式和实时模式。

直播模式密钥

要在实时模式下生成密钥:

  1. 打开 Stripe 开发者仪表板 并选择 API 钥匙。
  2. 在 标准密钥 部分中,选择 创建密钥。
  3. 输入 密钥名称,例如 n8n integration。
  4. 选择创建。显示新的 API 密钥。
  5. 复制密钥并将其输入到您的 n8n 凭证中作为密钥。

请参阅 Stripe 的 创建秘密 API 密钥 了解更多信息。

测试模式密钥

要在测试模式下使用密钥,您必须复制现有密钥:

  1. 转到 Stripe 测试模式开发人员仪表板 并选择 API 钥匙。
  2. 在 标准密钥 部分中,为 秘密密钥 选择 显示测试密钥。
  3. 复制密钥并将其输入到您的 n8n 凭证中作为密钥。

请参阅 Stripe 的 创建秘密 API 密钥 了解更多信息。

验证传入请求

提示

功能可用性

从 n8n 2.25.7 和 n8n 2.26.2 开始可以验证传入请求。

Stripe 触发器节点可以验证传入的 webhook 请求是否真正来自 Stripe。

n8n 强烈建议设置 签名密钥,以便其他人无法将伪造的事件发送到您的工作流程,即使他们知道您的 Webhook URL。

当您发布工作流时,n8n 会为您创建和管理 Stripe Webhook 端点,因此您可以在端点存在后设置 Signature Secret:

  1. 使用 Stripe 触发器 节点构建您的工作流程并发布。 n8n 在您的 Stripe 帐户中创建一个 Webhook 端点。
  2. 在 Stripe 仪表板中,转到 工作台 > Webhooks。在旧版仪表板中,转到 开发人员 > Webhooks。
  3. 选择创建的端点 n8n。您可以通过描述 Created by n8n for workflow ID: <workflow-id> 和 Webhook URL 来识别它,它与您的 n8n 生产 Webhook URL 相匹配。
  4. 在 签名密钥 下,选择 单击以显示 并复制该值。它以 whsec_ 开头。
  5. 在 n8n 中,打开您的 Stripe 凭证,将值粘贴到 Signature Secret 字段中,然后保存。

Stripe 为每个端点生成一个唯一的签名密钥,并为测试模式和实时模式生成一个单独的签名密钥。从与您正在使用的凭据匹配的端点复制密钥。请参阅 Stripe 的 Webhook 文档 了解更多信息。

测试模式和实时模式

所有 Stripe API 请求都发生在 测试模式 或实时模式中。每种模式都有自己的 API 密钥。

使用测试模式访问模拟测试数据,使用实时模式访问实际账户数据。一种模式下的对象无法被另一种模式访问。

请参阅 API 按键 | 测试模式与实时模式,了解有关每种模式的可用功能以及何时使用每种模式的指南的更多信息。

提示

两种模式的 n8n 凭证

如果您想同时使用实时模式和测试模式密钥,请将每种模式的密钥存储在单独的 n8n 凭证中。

按键前缀

Stripes 的密钥始终以 sk_ 开头:

  • 实时密钥以 sk_live_ 开头。
  • 测试密钥以 sk_test_ 开头。

n8n 尚未使用受限密钥(前缀 rk_)测试这些凭据。

警告

可发布密钥

请勿将可发布密钥(前缀为 pk_)与 n8n 凭证一起使用。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。