> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# N8N

> Integrasikan Dodo Payments dengan N8N untuk mengotomatiskan alur kerja dan terhubung dengan lebih dari 5.000 aplikasi menggunakan webhook—memberdayakan otomatisasi yang kuat dan dapat disesuaikan di lingkungan N8N yang di-host sendiri atau cloud.

## Pendahuluan

Sambungkan Dodo Payments ke ribuan aplikasi dan layanan melalui N8N. Otomatiskan alur kerja dengan memicu alur kerja N8N saat peristiwa pembayaran terjadi, mulai dari mengirim email hingga memperbarui spreadsheet, membuat tugas, operasi basis data, dan banyak lagi.

<Info>
  Integrasi ini memerlukan URL webhook N8N dari konfigurasi alur kerja Anda.
</Info>

## Memulai

<Steps>
  <Step title="Open the Webhook Section">
    Di dashboard Dodo Payments Anda, navigasikan ke <b>Webhooks → + Tambah Endpoint</b> dan buka dropdown integrasi.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/OBONg3OSDVHCK_pv/images/integrations/n8n.png?fit=max&auto=format&n=OBONg3OSDVHCK_pv&q=85&s=1477d1a9fdb4446ae4db5c976e7d6fb8" alt="Tambah Endpoint dan dropdown integrasi" style={{ maxHeight: '500px', width: 'auto' }} width="2870" height="1482" data-path="images/integrations/n8n.png" />
    </Frame>
  </Step>

  <Step title="Select N8N">
    Pilih kartu integrasi <b>N8N</b>.
  </Step>

  <Step title="Create Webhook in N8N">
    Di N8N, buat alur kerja baru dan tambahkan node <b>Webhook</b> sebagai pemicu. Konfigurasikan sebagai webhook POST dan salin URL webhooknya.
  </Step>

  <Step title="Paste Webhook URL">
    Tempel URL webhook N8N ke konfigurasi endpoint.
  </Step>

  <Step title="Configure Transformation">
    Edit kode transformasi untuk memformat data bagi alur kerja N8N Anda.
  </Step>

  <Step title="Test & Create">
    Uji dengan payload sampel dan klik <b>Create</b> untuk mengaktifkan integrasi.
  </Step>

  <Step title="Activate Workflow">
    Di N8N, aktifkan alur kerja Anda untuk mulai menerima event webhook.
  </Step>

  <Step title="Done!">
    🎉 Event pembayaran kini akan secara otomatis memicu alur kerja N8N Anda.
  </Step>
</Steps>

## Contoh Kode Transformasi

### Payload Webhook Dasar

```javascript basic_webhook.js icon="js" expandable theme={null}
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 || "USD",
      customer_email: p.customer.email,
      customer_name: p.customer.name,
      payment_method: p.payment_method || "unknown",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}
```

### Penangan Acara Langganan

```javascript subscription_webhook.js icon="js" expandable theme={null}
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),
        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;
}
```

### Penangan Pemberitahuan Sengketa

```javascript dispute_webhook.js icon="js" expandable theme={null}
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),
      status: d.dispute_status,
      stage: d.dispute_stage,
      remarks: d.remarks || "",
      urgent: webhook.eventType === "dispute.opened",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}
```

## Kasus Penggunaan N8N yang Populer

<AccordionGroup>
  <Accordion title="Email Notifications">
    * Kirim email Gmail/Outlook untuk konfirmasi pembayaran
    * Buat rangkaian email di Mailchimp/ConvertKit
    * Kirim notifikasi Slack/Discord melalui webhook
    * Buat catatan di Google Sheets secara otomatis
    * Kirim pesan Telegram/WhatsApp
  </Accordion>

  <Accordion title="CRM Updates">
    * Tambahkan kontak ke HubSpot/Salesforce
    * Buat peluang di Pipedrive/Close
    * Perbarui catatan pelanggan di Airtable
    * Catat aktivitas di Monday.com
    * Sinkronkan data ke database PostgreSQL/MySQL
  </Accordion>

  <Accordion title="Task Management">
    * Buat tugas di Asana/Trello
    * Tambahkan item yang harus dikerjakan di Notion
    * Buat acara kalender di Google Calendar
    * Kirim notifikasi SMS melalui Twilio
    * Buat isu GitHub untuk sengketa
  </Accordion>

  <Accordion title="Data Processing">
    * Transformasi dan perkaya data pembayaran
    * Simpan event di database (PostgreSQL, MongoDB)
    * Agregasi metrik dan analitik
    * Hasilkan laporan dan ekspor
    * Picu alur kerja multi-langkah yang kompleks
  </Accordion>
</AccordionGroup>

## Tips

* Jaga struktur payload tetap sederhana untuk memudahkan parsing node N8N
* Gunakan nama field yang konsisten di semua peristiwa
* Sertakan timestamp untuk penjadwalan dan waktu alur kerja
* Uji alur kerja Anda dengan data contoh sebelum mengaktifkan
* Gunakan node IF N8N untuk logika dan routing bersyarat
* Manfaatkan node Kode N8N untuk transformasi data kustom
* Gunakan node Switch untuk merutekan jenis peristiwa yang berbeda ke jalur yang berbeda
* Siapkan alur kerja kesalahan untuk menangani pengiriman webhook yang gagal

## Pemecahan Masalah

<AccordionGroup>
  <Accordion title="Workflow not triggering">
    * Verifikasi bahwa URL webhook sudah benar dan dapat diakses
    * Periksa bahwa alur kerja sudah diaktifkan di N8N
    * Pastikan node webhook dikonfigurasi dengan metode POST
    * Uji pengiriman webhook di riwayat eksekusi N8N
    * Verifikasi pengaturan firewall/jaringan mengizinkan webhook masuk
    * Periksa pengaturan otentikasi webhook N8N jika dikonfigurasi
  </Accordion>

  <Accordion title="Data not mapping correctly">
    * Periksa nama field di konfigurasi node N8N
    * Verifikasi tipe data sesuai dengan format yang diharapkan di node
    * Gunakan fitur uji N8N untuk memeriksa data masuk
    * Pastikan kode transformasi mengembalikan JSON yang valid
    * Periksa pengaturan format respons node webhook
    * Gunakan node Set untuk mengganti nama atau menyusun ulang field
  </Accordion>

  <Accordion title="Workflow execution errors">
    * Tinjau log eksekusi di N8N untuk pesan kesalahan yang lebih rinci
    * Periksa pengaturan koneksi dan kredensial node
    * Verifikasi semua field yang dibutuhkan ada dalam payload
    * Uji node individu dengan data sampel
    * Aktifkan alur kerja kesalahan untuk menangkap dan menangani kegagalan
    * Periksa batas laju dan kuota API untuk layanan yang terhubung
  </Accordion>
</AccordionGroup>