Zapier

Giới thiệu

Kết nối Dodo Payments với hàng nghìn ứng dụng thông qua Zapier. Mỗi sự kiện của Dodo Payments có thể khởi chạy một Zap để gửi email, thêm một hàng vào bảng tính, tạo task hoặc cập nhật bản ghi CRM.

Connector Zapier gửi từng sự kiện đến webhook URL của một Zap bắt đầu bằng Webhooks by Zapier. Webhooks by Zapier không khả dụng trong gói Zapier Free, vì vậy bạn cần một gói Zapier trả phí. Bạn cũng cần quyền truy cập vào Developer → Webhooks trong dashboard Dodo Payments.

Bắt đầu

Open the Webhook Section

Trong trang tổng quan Dodo Payments, đi đến Developer → Webhooks và nhấp vào Add endpoint.

Hộp thoại Add endpoint với Zapier được chọn trong menu thả xuống Integration và các bước How to connect Zapier

Select Zapier

Trong Integration, chọn Zapier. Dashboard sẽ tải transformation code của Zapier và hiển thị các bước thiết lập trong panel How to connect Zapier.

Create Zap in Zapier

Trong Zapier, tạo một Zap. Đối với trigger, chọn Webhooks by Zapier, chọn sự kiện Catch Hook rồi nhấp vào Continue. Trong tab Test của trigger, sao chép webhook URL.

Paste Webhook URL

Dán webhook URL của Zapier vào Endpoint URL. Connector Zapier không có trường API key.

Select Events

Subscribed events liệt kê các sự kiện mà connector Zapier hỗ trợ. Chỉ giữ lại những sự kiện mà transformation của bạn xử lý. Zapier chấp nhận mọi JSON, vì vậy một sự kiện không được transformation thay đổi vẫn khởi chạy Zap của bạn với payload gốc từ Dodo Payments.

Configure Transformation

Trong Transformation code, chỉnh sửa handler để gửi các field mà Zap của bạn sử dụng. Bắt đầu từ các ví dụ.

Test & Create

Trong Test this code, chọn một loại sự kiện và nhấp vào Simulate để xem trước payload. Sau đó nhấp vào Create endpoint.

Done

Các sự kiện đã đăng ký giờ đây sẽ được gửi đến Zap của bạn. Để tải các field mẫu vào Zapier, mở tab Testing của endpoint, chọn một loại sự kiện rồi nhấp vào Send example. Trong Zapier, nhấp vào Test trigger, ánh xạ các field trong các bước action rồi publish Zap.

Ví dụ về Transformation Code

Mỗi handler thay thế webhook.payload bằng một object phẳng và giữ nguyên webhook.url, webhook URL của Zapier. Các amount của Dodo Payments được tính theo đơn vị tiền tệ nhỏ nhất, vì vậy các ví dụ chia cho 100 và gửi kết quả dưới dạng string, chẳng hạn như "25.00". Đối với các loại tiền tệ không có chữ số thập phân như JPY và KRW, hãy sử dụng amount nguyên trạng.

Basic Webhook Payload

Gửi thông tin chi tiết của một payment thành công:

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,
      customer_email: p.customer.email,
      customer_name: p.customer.name,
      payment_method: p.payment_method || "unknown",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

Subscription Event Handler

Gửi một sự kiện subscription_started hoặc subscription_cancelled khi một subscription được kích hoạt hoặc bị hủy:

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),
        currency: s.currency,
        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 Alert Handler

Gửi mọi sự kiện dispute, với urgent được đặt thành true khi một dispute được mở:

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),
      currency: d.currency,
      status: d.dispute_status,
      stage: d.dispute_stage,
      remarks: d.remarks || "",
      urgent: webhook.eventType === "dispute.opened",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

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

Email Notifications

Gửi email Gmail hoặc Outlook để xác nhận payment
Thêm customer vào email sequence trong Mailchimp hoặc ConvertKit
Gửi thông báo Slack hoặc Discord
Thêm các hàng vào Google Sheets

CRM Updates

Thêm contact vào HubSpot hoặc Salesforce
Tạo deal trong Pipedrive hoặc Close
Cập nhật bản ghi customer trong Airtable
Ghi lại activity trong Monday.com

Task Management

Tạo task trong Asana hoặc Trello
Thêm mục việc cần làm trong Notion
Tạo sự kiện lịch
Gửi tin nhắn SMS thông qua Twilio

Mẹo

Giữ payload ở dạng phẳng để bạn dễ tìm từng field khi ánh xạ chúng trong Zapier.
Sử dụng cùng tên field cho các sự kiện để một Zap có thể xử lý nhiều loại sự kiện.
Bao gồm timestamp để Zap của bạn có thể ghi lại thời điểm mỗi sự kiện xảy ra.
Sau khi thay đổi transformation, hãy gửi một example mới và kiểm tra lại trigger trong Zapier để tải các field mới.
Để chỉ chạy các bước sau cho một số sự kiện nhất định, hãy thêm bước Filter by Zapier để kiểm tra event_type.
Để bỏ qua một sự kiện trong code, hãy đặt webhook.cancel = true trước khi return webhook. Logs ghi nhận một delivery bị bỏ qua là thành công.

Khắc phục sự cố

Zap Not Triggering

Kiểm tra để đảm bảo Endpoint URL khớp với webhook URL trong tab Test của trigger. URL sẽ thay đổi khi Zap được chuyển cho một người dùng Zapier khác.
Kiểm tra để đảm bảo Zap đã được publish và đang bật. Zapier trả về 404 cho một Zap đã tắt hoặc bị xóa, nhưng URL có thể tiếp tục trả về 200 trong tối đa vài giờ sau khi thay đổi.
Mở tab Logs trong Developer → Webhooks để xem phản hồi của Zapier đối với từng delivery.
Kiểm tra để đảm bảo sự kiện đã được chọn trong Subscribed events. Để thay đổi lựa chọn, hãy mở endpoint và nhấp vào Edit.

Data Not Mapping Correctly

Kiểm tra để đảm bảo tên field trong các bước action khớp với các key mà transformation của bạn gửi.
Kiểm tra để đảm bảo mỗi value có type mà action của bạn yêu cầu. Các ví dụ gửi amount dưới dạng string.
Kiểm tra để đảm bảo handler trả về webhook và webhook.payload là một JSON object. Nếu payload là một array, Zapier sẽ chạy Zap một lần cho mỗi item.
Sử dụng Test trigger trong Zapier để xem các field của sự kiện mới nhất.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Giới thiệu

Bắt đầu

Ví dụ về Transformation Code

Basic Webhook Payload

Subscription Event Handler

Dispute Alert Handler

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

Mẹo

Khắc phục sự cố

​Giới thiệu

​Bắt đầu

​Ví dụ về Transformation Code

​Basic Webhook Payload

​Subscription Event Handler

​Dispute Alert Handler

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

​Mẹo

​Khắc phục sự cố

Giới thiệu

Bắt đầu

Ví dụ về Transformation Code

Basic Webhook Payload

Subscription Event Handler

Dispute Alert Handler

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

Mẹo

Khắc phục sự cố