Kincir Angin

Pendahuluan

Jalankan skrip atau flow Windmill setiap kali event Dodo Payments terjadi. Gunakan untuk memperbarui database, menyinkronkan record ke sistem lain, mengirim notifikasi, atau menjalankan logika bisnis Anda sendiri dalam kode.

Konektor Windmill mengirim setiap event ke URL webhook skrip atau flow Windmill. Anda memerlukan skrip atau flow yang telah di-deploy, token Windmill yang dapat menjalankannya, dan akses ke Developer → Webhooks di dashboard Dodo Payments.

Memulai

Open the Webhook Section

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

Add endpoint dialog with Windmill selected in the Integration dropdown and the How to connect Windmill steps

Select Windmill

Di Integration, pilih Windmill. Dashboard memuat kode transformasi Windmill dan menampilkan langkah penyiapan di panel How to connect Windmill.

Copy the Windmill Webhook URL

Di Windmill, buka skrip atau flow yang akan menangani event. Pada tab Triggers, buka Webhooks lalu salin URL webhook asinkron (UUID/Async). Kemudian buat token khusus webhook untuk skrip atau flow tersebut dan salin tokennya. Token ini hanya dapat menjalankan skrip atau flow tersebut.

Paste Webhook URL

Tempel URL webhook Windmill ke Endpoint URL. URL harus menggunakan HTTPS, jadi instance Windmill yang di-host sendiri memerlukan alamat HTTPS publik. Konektor Windmill tidak memiliki field API key, jadi Anda menambahkan token setelah membuat endpoint.

Select Events

Subscribed events mencantumkan event yang didukung konektor Windmill. Pertahankan hanya event yang ditangani skrip atau flow Anda.

Configure Transformation

Di bawah Transformation code, edit handler agar key tingkat teratas payload sesuai dengan input skrip atau flow Anda. Mulai dari contoh.

Test & Create

Di bawah Test this code, pilih jenis event lalu klik Simulate untuk melihat pratinjau payload. Kemudian klik Create endpoint.

Add the Windmill Token

Segera setelah membuat endpoint, buka tab Advanced. Di bawah Custom headers, klik Add header. Masukkan Authorization sebagai nama, lalu Bearer, spasi, dan token Anda sebagai nilainya. Kemudian klik Save. Sebelum header disimpan, Windmill menolak delivery, dan Dodo Payments mencobanya kembali sesuai jadwal retry.Windmill juga menerima token dalam parameter query token di akhir URL. Windmill merekomendasikan header karena siapa pun yang dapat melihat URL dengan token dapat menggunakan token tersebut.

Done

Subscribed events kini memulai run skrip atau flow Anda. Untuk mengirim event pengujian, buka tab Testing endpoint, pilih jenis event, lalu klik Send example. Di Windmill, run tersebut muncul di halaman Runs dengan trigger Webhook.

Contoh Kode Transformasi

Setiap handler mengganti webhook.payload dengan objek datar dan mempertahankan webhook.url, yaitu URL webhook Windmill Anda. Windmill meneruskan setiap key tingkat teratas ke input skrip atau flow dengan nama yang sama, sehingga skrip untuk contoh pertama mendeklarasikan input seperti event_type, payment_id, dan amount. Jumlah Dodo Payments menggunakan unit mata uang terkecil, sehingga contoh-contoh tersebut membaginya dengan 100 dan mengirim hasilnya sebagai string, seperti "25.00". Untuk mata uang tanpa desimal seperti JPY dan KRW, gunakan jumlah tersebut apa adanya.

Payload Workflow Dasar

Kirim detail pembayaran yang berhasil:

basic_workflow.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,
      metadata: {
        business_id: p.business_id,
        product_id: p.product_cart ? p.product_cart.map(i => i.product_id).join(', ') : undefined
      }
    };
  }
  return webhook;
}

Handler Workflow Subscription

Kirim event subscription_started atau subscription_cancelled saat subscription menjadi aktif atau dibatalkan:

subscription_workflow.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,
        customer_id: s.customer.customer_id,
        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,
        customer_id: s.customer.customer_id,
        timestamp: webhook.payload.timestamp
      };
      break;
  }
  return webhook;
}

Handler Workflow Dispute

Kirim setiap event dispute, dengan urgent ditetapkan ke true saat dispute dibuka:

dispute_workflow.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",
      business_id: d.business_id,
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

Kasus Penggunaan Windmill yang Umum

Database Operations

Perbarui record pelanggan di PostgreSQL atau MySQL
Catat event pembayaran ke data warehouse
Sinkronkan data ke sistem eksternal
Perbarui tingkat inventaris
Lacak metrik analitik

Business Logic

Hitung metrik pendapatan
Proses refund dan penyesuaian
Tangani perubahan siklus hidup subscription
Buat laporan dan ekspor
Validasi data pembayaran

External Integrations

Kirim data ke platform analitik
Perbarui sistem CRM
Mulai kampanye email
Buat event kalender
Kirim notifikasi SMS

Tips

Beri nama key payload sesuai dengan input skrip atau flow Anda karena Windmill memetakan setiap key tingkat teratas ke input dengan nama yang sama.
Gunakan nama field yang sama di berbagai event agar satu skrip dapat menangani beberapa jenis event.
Sertakan jenis event dan timestamp. Event dapat tiba tidak berurutan, dan timestamp memungkinkan skrip Anda mengurutkannya.
Gunakan URL webhook asinkron. URL sinkron menunggu hingga run selesai, dan run yang melebihi timeout delivery dianggap sebagai delivery yang gagal dan akan dicoba kembali oleh Dodo Payments.
Pastikan skrip Anda aman dijalankan dua kali untuk event yang sama karena retry dapat mengirimkan event lebih dari sekali.
Untuk melewati event dalam kode, tetapkan webhook.cancel = true sebelum mengembalikan webhook. Log mencatat delivery yang dilewati sebagai berhasil.
Gunakan error handlers Windmill untuk mendapatkan notifikasi saat run gagal.

Pemecahan Masalah

Workflows Not Triggering

Pastikan Endpoint URL adalah URL webhook skrip atau flow Anda dan endpoint tersebut diaktifkan.
Pastikan header Authorization berisi Bearer dan token yang valid. Token khusus webhook hanya menjalankan skrip atau flow miliknya sendiri.
Pastikan skrip atau flow telah di-deploy. Webhook menjalankan versi terbaru yang di-deploy, bukan draft.
Buka tab Logs di Developer → Webhooks untuk melihat respons Windmill terhadap setiap delivery.

Data Processing Issues

Pastikan key tingkat teratas payload sesuai dengan input skrip atau flow berdasarkan namanya.
Pastikan setiap nilai sesuai dengan tipe inputnya. Contoh-contoh tersebut mengirim jumlah sebagai string.
Periksa run di halaman Runs Windmill, difilter berdasarkan trigger Webhook. URL asinkron merespons segera setelah Windmill mengantrekan run, sehingga log Dodo Payments menampilkan delivery yang berhasil meskipun run gagal.
Jalankan skrip atau flow di Windmill dengan payload dari Simulate.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Kode Transformasi

Payload Workflow Dasar

Handler Workflow Subscription

Handler Workflow Dispute

Kasus Penggunaan Windmill yang Umum

Tips

Pemecahan Masalah

​Pendahuluan

​Memulai

​Contoh Kode Transformasi

​Payload Workflow Dasar

​Handler Workflow Subscription

​Handler Workflow Dispute

​Kasus Penggunaan Windmill yang Umum

​Tips

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Kode Transformasi

Payload Workflow Dasar

Handler Workflow Subscription

Handler Workflow Dispute

Kasus Penggunaan Windmill yang Umum

Tips

Pemecahan Masalah