n8n

介绍

n8n 集成会在每次发生支付事件时启动 n8n 工作流，因此你可以将 Dodo Payments 连接到 n8n 集成的任何应用。工作流可以发送电子邮件、更新电子表格、创建任务、写入数据库等。

此集成需要使用 n8n 工作流中 Webhook 节点提供的 webhook URL。

开始使用

Open the Webhook Section

在 Dodo Payments 控制面板中，前往 Developer → Webhooks，然后点击 Add endpoint。

已在 Integration 下拉菜单中选择 n8n 的 Add endpoint 对话框

Select n8n

在 Integration 列表中选择 n8n。

Create Webhook in n8n

在 n8n 中创建一个工作流，并添加 Webhook 节点作为触发器。将 HTTP Method 设置为 POST，然后复制 Production URL。只有在 n8n 正在等待测试事件时，测试 URL 才会接收事件。

Paste Webhook URL

将 n8n 生产 URL 粘贴到 Endpoint URL 字段中。

Configure Transformation

编辑 Transformation code 下的代码，为你的 n8n 工作流构造数据。请从下面的示例开始。

Test & Create

在 Test this code 下，针对示例 payload 运行转换，然后点击 Create endpoint。

Publish the Workflow

在 n8n 中发布你的工作流。只有在工作流发布后，n8n 才会注册生产 webhook URL。

Done

支付事件现在会触发你的 n8n 工作流。

转换代码示例

每个示例都会将 Dodo Payments 事件展平为一个小型 JSON 对象，n8n 节点可以直接读取该对象。

基本 Webhook Payload

此示例会在支付成功时发送支付金额、货币、客户和支付方式。

basic_webhook.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      event_type: webhook.eventType,
      payment_id: p.payment_id,
      amount: (p.total_amount / 100).toFixed(2),
      currency: p.currency || "USD",
      customer_email: p.customer.email,
      customer_name: p.customer.name,
      payment_method: p.payment_method || "unknown",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

订阅事件处理程序

此示例会发送一个 subscription_started 或 subscription_cancelled 事件，以便一个工作流可以根据 event_type 进行分支。

subscription_webhook.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        event_type: "subscription_started",
        subscription_id: s.subscription_id,
        customer_email: s.customer.email,
        customer_name: s.customer.name,
        product_id: s.product_id,
        amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
        frequency: s.payment_frequency_interval,
        next_billing: s.next_billing_date,
        timestamp: webhook.payload.timestamp
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        event_type: "subscription_cancelled",
        subscription_id: s.subscription_id,
        customer_email: s.customer.email,
        cancelled_at: s.cancelled_at,
        cancel_at_next_billing: s.cancel_at_next_billing_date,
        timestamp: webhook.payload.timestamp
      };
      break;
  }
  return webhook;
}

争议提醒处理程序

此示例会发送每个 dispute.* 事件，并在争议开启时将 urgent 设置为 true。

dispute_webhook.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      event_type: webhook.eventType,
      dispute_id: d.dispute_id,
      payment_id: d.payment_id,
      amount: (d.amount / 100).toFixed(2),
      status: d.dispute_status,
      stage: d.dispute_stage,
      remarks: d.remarks || "",
      urgent: webhook.eventType === "dispute.opened",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

常见 N8N 使用场景

以下是商户基于 Dodo Payments 事件构建的常见工作流。

Email Notifications

通过 Gmail 或 Outlook 发送支付确认邮件。
在 Mailchimp 或 ConvertKit 中创建邮件序列。
通过 webhook 发送 Slack 或 Discord 通知。
创建 Google Sheets 记录。
发送 Telegram 或 WhatsApp 消息。

CRM Updates

将联系人添加到 HubSpot 或 Salesforce。
在 Pipedrive 或 Close 中创建交易。
更新 Airtable 中的客户记录。
在 Monday.com 中记录活动。
将数据同步到 PostgreSQL 或 MySQL 数据库。

Task Management

在 Asana 或 Trello 中创建任务。
在 Notion 中添加待办事项。
在 Google Calendar 中创建事件。
通过 Twilio 发送 SMS 通知。
为争议创建 GitHub issue。

Data Processing

转换并丰富支付数据。
将事件存储在 PostgreSQL 或 MongoDB 等数据库中。
汇总指标和分析数据。
生成报告和导出文件。
触发多步骤工作流。

提示

保持 payload 结构简单，以便 n8n 节点能够解析。
在所有事件中使用相同的字段名称。
包含时间戳，以便进行工作流计时和调度。
在发布工作流之前，使用示例数据进行测试。
使用 IF 节点实现条件逻辑和路由。
使用 Code 节点执行自定义数据转换。
使用 Switch 节点将每种事件类型路由到各自的路径。
在 n8n 中设置错误工作流，以捕获执行失败。

故障排除

Workflow Not Triggering

检查 endpoint 是否使用 n8n 生产 URL，以及是否可以从互联网访问 n8n。
检查工作流是否已在 n8n 中发布。
检查 Webhook 节点的 HTTP Method 是否为 POST。
在工作流的 Executions 选项卡中检查传入请求。
检查防火墙和网络设置是否允许传入 webhook。
如果 Webhook 节点需要身份验证，请在 Custom Headers 下的 endpoint 中添加匹配的标头。

Data Not Mapping Correctly

检查 n8n 节点配置中的字段名称。
检查数据类型是否符合节点预期的格式。
使用 n8n 测试 URL 检查传入数据。
检查转换代码是否返回有效的 JSON。
检查 Webhook 节点的响应设置。
使用 Edit Fields (Set) 节点重命名或重构字段。

Workflow Execution Errors

查看 n8n 中的执行日志，获取详细的错误消息。
检查节点连接设置和凭据。
检查 payload 中是否包含所有必需字段。
使用示例数据测试各个节点。
启用错误工作流，以捕获并处理失败。
检查已连接服务的速率限制和 API 配额。

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

介绍

开始使用

转换代码示例

基本 Webhook Payload

订阅事件处理程序

争议提醒处理程序

常见 N8N 使用场景

提示

故障排除

​介绍

​开始使用

​转换代码示例

​基本 Webhook Payload

​订阅事件处理程序

​争议提醒处理程序

​常见 N8N 使用场景

​提示

​故障排除

介绍

开始使用

转换代码示例

基本 Webhook Payload

订阅事件处理程序

争议提醒处理程序

常见 N8N 使用场景

提示

故障排除