Skip to main content

Giới thiệu

Tích hợp n8n sẽ khởi chạy một workflow n8n mỗi khi có sự kiện thanh toán xảy ra, giúp bạn kết nối Dodo Payments với bất kỳ ứng dụng nào mà n8n tích hợp. Workflow có thể gửi email, cập nhật bảng tính, tạo tác vụ, ghi dữ liệu vào cơ sở dữ liệu và nhiều hơn nữa.
Tích hợp này yêu cầu URL webhook từ một node Webhook trong workflow n8n của bạn.

Bắt đầu

1

Open the Webhook Section

Trong trang tổng quan Dodo Payments, hãy đi đến Developer → Webhooks và nhấp vào Add endpoint.
Add endpoint dialog with n8n selected in the Integration dropdown
2

Select n8n

Trong danh sách Integration, chọn n8n.
3

Create Webhook in n8n

Trong n8n, tạo một workflow và thêm node Webhook làm trigger. Đặt HTTP Method thành POST, sau đó sao chép Production URL. URL kiểm thử chỉ nhận sự kiện trong khi n8n đang lắng nghe một sự kiện kiểm thử.
4

Paste Webhook URL

Dán URL production của n8n vào trường Endpoint URL.
5

Configure Transformation

Chỉnh sửa code bên dưới Transformation code để định dạng dữ liệu cho workflow n8n của bạn. Bắt đầu từ các ví dụ bên dưới.
6

Test & Create

Trong Test this code, chạy phép chuyển đổi với một payload mẫu, sau đó nhấp vào Create endpoint.
7

Publish the Workflow

Trong n8n, publish workflow của bạn. n8n chỉ đăng ký URL webhook production khi workflow được publish.
8

Done

Các sự kiện thanh toán hiện sẽ kích hoạt workflow n8n của bạn.

Ví Dụ Mã Biến Đổi

Mỗi ví dụ chuyển một sự kiện Dodo Payments thành một đối tượng JSON nhỏ mà các node n8n có thể đọc trực tiếp.

Payload Webhook cơ bản

Ví dụ này gửi số tiền thanh toán, currency, khách hàng và phương thức thanh toán khi một khoản thanh toán thành công.
basic_webhook.js

Trình xử lý sự kiện Subscription

Ví dụ này gửi một sự kiện subscription_started hoặc subscription_cancelled, để một workflow có thể phân nhánh dựa trên event_type.
subscription_webhook.js

Trình xử lý cảnh báo Dispute

Ví dụ này gửi mọi sự kiện dispute.* và đặt urgent thành true khi một dispute được mở.
dispute_webhook.js

Các trường hợp sử dụng N8N phổ biến

Đây là những workflow phổ biến mà merchant xây dựng dựa trên các sự kiện Dodo Payments.
  • Gửi email Gmail hoặc Outlook để xác nhận thanh toán.
  • Tạo chuỗi email trong Mailchimp hoặc ConvertKit.
  • Gửi thông báo Slack hoặc Discord thông qua webhook.
  • Tạo bản ghi Google Sheets.
  • Gửi tin nhắn Telegram hoặc WhatsApp.
  • Thêm contact vào HubSpot hoặc Salesforce.
  • Tạo deal trong Pipedrive hoặc Close.
  • Cập nhật bản ghi khách hàng trong Airtable.
  • Ghi lại hoạt động trong Monday.com.
  • Đồng bộ dữ liệu với cơ sở dữ liệu PostgreSQL hoặc MySQL.
  • Tạo tác vụ trong Asana hoặc Trello.
  • Thêm mục việc cần làm trong Notion.
  • Tạo sự kiện trong Google Calendar.
  • Gửi thông báo SMS thông qua Twilio.
  • Tạo issue GitHub cho các dispute.
  • Chuyển đổi và bổ sung dữ liệu thanh toán.
  • Lưu trữ sự kiện trong các cơ sở dữ liệu như PostgreSQL hoặc MongoDB.
  • Tổng hợp các chỉ số và dữ liệu phân tích.
  • Tạo báo cáo và bản xuất dữ liệu.
  • Kích hoạt workflow nhiều bước.

Mẹo

  • Giữ cấu trúc payload đơn giản để các node n8n có thể phân tích cú pháp.
  • Sử dụng cùng tên trường cho tất cả sự kiện.
  • Bao gồm timestamp để tính thời gian và lên lịch cho workflow.
  • Kiểm thử workflow bằng dữ liệu mẫu trước khi publish.
  • Sử dụng node IF cho logic điều kiện và định tuyến.
  • Sử dụng node Code để tùy chỉnh việc chuyển đổi dữ liệu.
  • Sử dụng node Switch để định tuyến từng loại sự kiện đến đường dẫn riêng.
  • Thiết lập error workflow trong n8n để bắt các lần thực thi thất bại.

Khắc phục sự cố

  • Kiểm tra endpoint sử dụng URL production của n8n và n8n có thể được truy cập từ internet.
  • Kiểm tra workflow đã được publish trong n8n.
  • Kiểm tra HTTP Method của node Webhook là POST.
  • Kiểm tra các request đến trong tab Executions của workflow.
  • Kiểm tra cài đặt firewall và network có cho phép webhook đến hay không.
  • Nếu node Webhook yêu cầu authentication, hãy thêm header tương ứng vào endpoint tại Custom Headers.
  • Kiểm tra tên trường trong cấu hình node n8n.
  • Kiểm tra các kiểu dữ liệu khớp với định dạng mà node yêu cầu.
  • Sử dụng URL kiểm thử của n8n để kiểm tra dữ liệu đến.
  • Kiểm tra code chuyển đổi trả về JSON hợp lệ.
  • Kiểm tra cài đặt response của node Webhook.
  • Sử dụng node Edit Fields (Set) để đổi tên hoặc tái cấu trúc các trường.
  • Xem lại execution logs trong n8n để biết thông báo lỗi chi tiết.
  • Kiểm tra cài đặt kết nối node và credentials.
  • Kiểm tra tất cả trường bắt buộc có trong payload.
  • Kiểm thử từng node bằng dữ liệu mẫu.
  • Bật error workflow để bắt và xử lý lỗi.
  • Kiểm tra rate limits và API quotas của các dịch vụ được kết nối.
Lần sửa đổi cuối 28 tháng 9, 2026