Keplars

Kirim email transaksional melalui Keplars saat terjadi peristiwa pembayaran dan subscription Dodo Payments, tanpa server middleware.

​

Pendahuluan

Kirim email transaksional secara otomatis saat terjadi peristiwa pembayaran dan subscription. Konfirmasi pembayaran, pembaruan subscription, dan notifikasi kegagalan dikirim melalui Keplars tanpa server middleware: Dodo Payments memanggil API Keplars secara langsung menggunakan handler transformasi JavaScript.

Integrasi ini melakukan autentikasi dengan API key Keplars Anda. Temukan API key tersebut di dashboard Keplars pada Settings → API Keys, lalu verifikasi domain atau alamat pengirim pada Domains.

​

Memulai

1. Open the Webhook Section

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

2. Select Keplars

   Di Integration, pilih Keplars. Template akan mengisi URL API Keplars dan kode transformasi.

   
3. Enter API Key

   Tempelkan API key Keplars Anda ke API key. Dodo Payments mengirimkannya sebagai Bearer token pada setiap request. Di bagian Subscribed events, pilih event yang harus mengirim email.

   
4. Configure Transformation

   Di Transformation code, edit kode untuk memformat email untuk Keplars. Ganti ID template placeholder dengan milik Anda.

5. Test & Create

   Pada Test this code, pilih jenis peristiwa dan klik Simulate untuk menjalankan transformasi terhadap sample payload. Kemudian klik Create endpoint untuk mulai mengirim email.

6. Done

   Peristiwa Dodo Payments kini mengirim email transaksional melalui Keplars.

​

Contoh Kode Transformasi

Setiap handler menetapkan webhook.url ke endpoint pengiriman prioritas tinggi Keplars dan menulis ulang webhook.payload menjadi request Keplars. Dodo Payments menambahkan API key sebagai Bearer token. Ganti your-keplars-*-template-id dengan ID template Anda. API pengiriman Keplars tidak memiliki field from, sehingga Keplars mengirim setiap email dari sender yang Anda siapkan di dashboard Keplars.

to harus berupa array, bahkan untuk satu penerima. Saat menggunakan template_id, jangan juga mengirim subject atau body, karena template akan menyediakannya.

​

Email Konfirmasi Pembayaran

payment_succeeded.js

function handler(webhook) {
  if (webhook.eventType !== "payment.succeeded") return webhook;

  const data = webhook.payload.data || {};
  const paymentDate = new Date(webhook.payload.timestamp).toLocaleDateString("en-US", {
    year: "numeric", month: "long", day: "numeric",
  });

  webhook.url = "https://api.keplars.com/api/v1/send-email/high";
  webhook.payload = {
    to: [data.customer?.email],
    template_id: "your-keplars-payment-success-template-id",
    params: {
      customer_name: data.customer?.name,
      amount: ((data.total_amount || 0) / 100).toFixed(2),
      currency: data.currency || "USD",
      payment_id: data.payment_id,
      payment_method: data.payment_method,
      payment_date: paymentDate,
    },
  };
  return webhook;
}

​

Notifikasi Kegagalan Pembayaran

payment_failed.js

function handler(webhook) {
  if (webhook.eventType !== "payment.failed") return webhook;

  const data = webhook.payload.data || {};
  const paymentDate = new Date(webhook.payload.timestamp).toLocaleDateString("en-US", {
    year: "numeric", month: "long", day: "numeric",
  });

  webhook.url = "https://api.keplars.com/api/v1/send-email/high";
  webhook.payload = {
    to: [data.customer?.email],
    template_id: "your-keplars-payment-failed-template-id",
    params: {
      customer_name: data.customer?.name,
      amount: ((data.total_amount || 0) / 100).toFixed(2),
      currency: data.currency || "USD",
      payment_id: data.payment_id,
      error_message: data.error_message || "Your payment could not be processed.",
      payment_date: paymentDate,
    },
  };
  return webhook;
}

​

Email Selamat Datang Berlangganan

subscription_active.js

function handler(webhook) {
  if (webhook.eventType !== "subscription.active") return webhook;

  const data = webhook.payload.data || {};
  const nextBilling = data.next_billing_date
    ? new Date(data.next_billing_date).toLocaleDateString("en-US", {
        year: "numeric", month: "long", day: "numeric",
      })
    : "";

  webhook.url = "https://api.keplars.com/api/v1/send-email/high";
  webhook.payload = {
    to: [data.customer?.email],
    template_id: "your-keplars-subscription-active-template-id",
    params: {
      customer_name: data.customer?.name,
      subscription_id: data.subscription_id,
      product_id: data.product_id,
      amount: ((data.recurring_pre_tax_amount || 0) / 100).toFixed(2),
      currency: data.currency || "USD",
      billing_interval: data.payment_frequency_interval || "Month",
      next_billing_date: nextBilling,
    },
  };
  return webhook;
}

​

Email Pembatalan Langganan

subscription_cancelled.js

function handler(webhook) {
  if (webhook.eventType !== "subscription.cancelled") return webhook;

  const data = webhook.payload.data || {};
  const cancellationDate = new Date(webhook.payload.timestamp).toLocaleDateString("en-US", {
    year: "numeric", month: "long", day: "numeric",
  });

  webhook.url = "https://api.keplars.com/api/v1/send-email/high";
  webhook.payload = {
    to: [data.customer?.email],
    template_id: "your-keplars-subscription-cancelled-template-id",
    params: {
      customer_name: data.customer?.name,
      subscription_id: data.subscription_id,
      cancellation_date: cancellationDate,
    },
  };
  return webhook;
}

​

Tips

• Kirim dari domain atau alamat yang telah diverifikasi untuk meningkatkan keterkiriman.
• Buat satu template Keplars untuk setiap jenis event agar setiap email tetap sesuai dengan brand dan pesannya.
• Personalisasikan setiap email dengan mengirimkan data pelanggan, seperti nama, jumlah, dan ID pembayaran, dalam params.
• Uji terlebih dahulu dalam mode sandbox. Keplars menyimpan pengiriman sandbox di Test Inbox-nya, bukan mengirimkannya ke penerima.

​

Pemecahan Masalah

Emails not being sent

• Periksa apakah API key Anda benar dan aktif di Keplars pada Settings → API Keys.
• Periksa apakah domain atau alamat sender Anda telah diverifikasi.
• Di dashboard Dodo Payments, buka pesan di tab Logs pada Developer → Webhooks. Setiap upaya pengiriman menampilkan respons error mentah dari Keplars.

Template not found

• template_id dalam handler Anda harus cocok dengan template aktif di akun Keplars Anda. Periksa ID dan pastikan template tersebut aktif di dashboard Keplars.

Wrong event triggered

• Setiap handler memeriksa webhook.eventType dan mengembalikan webhook tanpa perubahan jika event tidak cocok. Periksa apakah Subscribed events endpoint hanya mencakup event yang Anda inginkan.