Inngest

Pendahuluan

Jalankan fungsi Inngest dan pekerjaan latar belakang saat event pembayaran terjadi. Dodo Payments mengirim setiap event ke Inngest, tempat fungsi Anda dapat mengirim notifikasi, memperbarui database, dan menjalankan alur kerja multi-langkah dengan fitur percobaan ulang dan penanganan error Inngest.

Anda memerlukan URL webhook Inngest. Buat URL tersebut di dasbor Inngest melalui Manage → Webhooks.

Memulai

Open the Webhook Section

Di dasbor Dodo Payments, buka Developer → Webhooks dan klik Add endpoint.

Add endpoint dialog with Inngest selected in the Integration dropdown

Select Inngest

Di Integration, pilih Inngest. Di bagian Subscribed events, pilih event yang harus memicu fungsi Anda.

Create an Inngest Webhook

Di dasbor Inngest, buka tab Manage dan pilih Webhooks. Buat webhook dan salin URL-nya. Inngest menjalankan fungsi transformasi webhook pada setiap request, jadi pastikan fungsi tersebut tetap menyertakan field name dan data yang diharapkan fungsi Anda.

Paste Webhook URL

Tempel URL webhook Inngest ke Endpoint URL.

Configure Transformation

Di Transformation code, edit kode untuk memformat event untuk fungsi Inngest Anda. Lihat contoh di bawah.

Test & Create

Di bagian Test this code, pilih jenis event dan klik Simulate untuk menjalankan transformasi menggunakan sample payload. Kemudian klik Create endpoint untuk mengaktifkan integrasi.

Done

Event Dodo Payments sekarang memicu fungsi Inngest Anda.

Contoh Kode Transformasi

Setiap contoh menulis ulang webhook.payload menjadi event Inngest. name adalah event yang memicu fungsi Anda, data berisi detail event, user berisi data customer, dan ts adalah waktu event dalam milidetik, yang diperlukan oleh format event 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 ini meneruskan setiap event dispute.* dan menandai dispute.opened sebagai urgent. Payload sengketa tidak menyertakan detail customer, jadi handler ini tidak mengirim objek 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;
}

Kasus Penggunaan Inngest yang Umum

Payment Processing

Mengirim email konfirmasi
Memperbarui data customer
Memproses refund
Membuat invoice
Memperbarui inventaris

Subscription Management

Menyambut subscriber baru
Memproses pembatalan
Mengirim pengingat perpanjangan
Memperbarui siklus penagihan
Menangani pembayaran yang gagal

Analytics & Reporting

Memperbarui metrik pendapatan
Melacak perilaku customer
Membuat laporan
Menyinkronkan data ke platform analitik
Menghitung tingkat churn

Tips

Gunakan nama event yang deskriptif. Inngest merekomendasikan pemberian awalan berdasarkan sumber, seperti dodo/payment.succeeded.
Letakkan detail customer di user, yang dienkripsi Inngest saat disimpan.
Atur ts dari timestamp milik webhook, dalam milidetik, agar event mempertahankan urutan dan waktu aslinya.
Gunakan struktur data yang sama di seluruh event.
Gunakan fitur percobaan ulang dan penanganan error Inngest.

Pemecahan Masalah

Functions not triggering

Periksa apakah URL endpoint sesuai dengan URL webhook Inngest Anda dan webhook tersebut aktif.
Periksa apakah fungsi Inngest Anda telah di-deploy dan aktif.
Periksa apakah nama event sesuai dengan trigger fungsi Anda.
Tinjau log fungsi Inngest untuk menemukan error.

Data not received correctly

Periksa apakah struktur payload sesuai dengan format event Inngest.
Periksa apakah nama event diformat dengan benar.
Periksa apakah fungsi transformasi webhook Inngest tetap menyertakan field yang ditetapkan oleh transformasi Dodo Payments.
Periksa apakah semua field yang diperlukan telah disertakan.
Uji menggunakan alat pengujian webhook Inngest.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Kode Transformasi

Basic Event Payload

Subscription Event Handler

Dispute Event Handler

Kasus Penggunaan Inngest yang Umum

Tips

Pemecahan Masalah

​Pendahuluan

​Memulai

​Contoh Kode Transformasi

​Basic Event Payload

​Subscription Event Handler

​Dispute Event Handler

​Kasus Penggunaan Inngest yang Umum

​Tips

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Kode Transformasi

Basic Event Payload

Subscription Event Handler

Dispute Event Handler

Kasus Penggunaan Inngest yang Umum

Tips

Pemecahan Masalah