Inngest

Giới thiệu

Chạy các function của Inngest và background job khi xảy ra các sự kiện payment. Dodo Payments gửi từng sự kiện đến Inngest, nơi các function của bạn có thể gửi thông báo, cập nhật database và chạy các workflow nhiều bước với tính năng retry và xử lý lỗi của Inngest.

Bạn cần một URL webhook của Inngest. Bạn tạo URL này trong Inngest dashboard tại Manage → Webhooks.

Bắt đầu

Open the Webhook Section

Trong dashboard Dodo Payments, đi đến Developer → Webhooks và nhấp vào Add endpoint.

Add endpoint dialog with Inngest selected in the Integration dropdown

Select Inngest

Trong Integration, chọn Inngest. Trong Subscribed events, chọn các sự kiện sẽ kích hoạt function của bạn.

Create an Inngest Webhook

Trong Inngest dashboard, mở tab Manage và chọn Webhooks. Tạo một webhook và sao chép URL của webhook. Inngest chạy transform function của webhook trên mỗi request, vì vậy hãy kiểm tra để đảm bảo function này giữ lại các field name và data mà các function của bạn yêu cầu.

Paste Webhook URL

Dán URL webhook của Inngest vào Endpoint URL.

Configure Transformation

Trong Transformation code, chỉnh sửa code để định dạng các sự kiện cho các function Inngest của bạn. Xem các ví dụ bên dưới.

Test & Create

Trong Test this code, chọn một loại sự kiện và nhấp vào Simulate để chạy transformation trên một payload mẫu. Sau đó nhấp vào Create endpoint để kích hoạt integration.

Done

Các sự kiện Dodo Payments giờ đây sẽ kích hoạt các function Inngest của bạn.

Ví dụ Mã Biến đổi

Mỗi ví dụ chuyển đổi webhook.payload thành một sự kiện Inngest. name là sự kiện mà function của bạn kích hoạt, data chứa thông tin chi tiết về sự kiện, user chứa thông tin customer và ts là thời gian sự kiện tính bằng milliseconds, theo yêu cầu của event format của Inngest.

Basic Event Payload

basic_event.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      name: "payment.succeeded",
      data: {
        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"
      },
      user: {
        email: p.customer.email
      },
      ts: new Date(webhook.payload.timestamp).getTime()
    };
  }
  return webhook;
}

Subscription Event Handler

subscription_event.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        name: "subscription.started",
        data: {
          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
        },
        user: {
          email: s.customer.email
        },
        ts: new Date(webhook.payload.timestamp).getTime()
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        name: "subscription.cancelled",
        data: {
          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
        },
        user: {
          email: s.customer.email
        },
        ts: new Date(webhook.payload.timestamp).getTime()
      };
      break;
  }
  return webhook;
}

Dispute Event Handler

Handler này chuyển tiếp mọi sự kiện dispute.* và đánh dấu dispute.opened là khẩn cấp. Dispute payload không bao gồm thông tin customer, vì vậy handler không gửi object user.

dispute_event.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      name: webhook.eventType,
      data: {
        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"
      },
      ts: new Date(webhook.payload.timestamp).getTime()
    };
  }
  return webhook;
}

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

Payment Processing

Gửi email xác nhận
Cập nhật bản ghi customer
Xử lý refund
Tạo invoice
Cập nhật inventory

Subscription Management

Chào mừng subscriber mới
Xử lý cancellation
Gửi lời nhắc gia hạn
Cập nhật billing cycle
Xử lý payment thất bại

Analytics & Reporting

Cập nhật các chỉ số doanh thu
Theo dõi hành vi customer
Tạo report
Đồng bộ dữ liệu với các nền tảng analytics
Tính churn rate

Mẹo

Sử dụng tên sự kiện có tính mô tả. Inngest khuyến nghị thêm tiền tố là nguồn, chẳng hạn như dodo/payment.succeeded.
Đặt thông tin customer vào user, nơi Inngest mã hóa dữ liệu khi lưu trữ.
Đặt ts từ timestamp của webhook, tính bằng milliseconds, để các sự kiện giữ nguyên thứ tự và thời gian ban đầu.
Sử dụng cùng một cấu trúc dữ liệu cho các sự kiện.
Sử dụng các tính năng retry và xử lý lỗi của Inngest.

Khắc phục sự cố

Functions not triggering

Kiểm tra để đảm bảo Endpoint URL khớp với URL webhook của Inngest và webhook đang hoạt động.
Kiểm tra để đảm bảo function Inngest của bạn đã được deploy và đang hoạt động.
Kiểm tra để đảm bảo tên sự kiện khớp với các trigger của function.
Xem log của function Inngest để tìm lỗi.

Data not received correctly

Kiểm tra để đảm bảo cấu trúc payload khớp với event format của Inngest.
Kiểm tra để đảm bảo tên sự kiện được định dạng chính xác.
Kiểm tra để đảm bảo transform function của Inngest webhook giữ lại các field mà transformation của Dodo Payments thiết lập.
Kiểm tra để đảm bảo tất cả field bắt buộc đều được đưa vào.
Kiểm thử bằng công cụ kiểm thử webhook của Inngest.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Giới thiệu

Bắt đầu

Ví dụ Mã Biến đổi

Basic Event Payload

Subscription Event Handler

Dispute Event Handler

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

Mẹo

Khắc phục sự cố

​Giới thiệu

​Bắt đầu

​Ví dụ Mã Biến đổi

​Basic Event Payload

​Subscription Event Handler

​Dispute Event Handler

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

​Mẹo

​Khắc phục sự cố

Giới thiệu

Bắt đầu

Ví dụ Mã Biến đổi

Basic Event Payload

Subscription Event Handler

Dispute Event Handler

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

Mẹo

Khắc phục sự cố