Keplars

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

Open the Webhook Section

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

Select Keplars

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

Enter API Key

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

Masukkan URL API Keplars, API Key, dan berlangganan ke peristiwa

Configure Transformation

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

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.

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 payments@mail.yourdomain.com dengan pengirim yang telah diverifikasi, dan ganti your-keplars-*-template-id dengan ID template Anda.

to harus berupa array, bahkan untuk satu penerima. Saat Anda menggunakan template_id, jangan juga mengirim subject atau body, karena template 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],
    from: "payments@mail.yourdomain.com",
    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],
    from: "payments@mail.yourdomain.com",
    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 Sambutan Subscription

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],
    from: "payments@mail.yourdomain.com",
    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 Subscription

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],
    from: "payments@mail.yourdomain.com",
    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 deliverability.
Buat satu template Keplars untuk setiap jenis peristiwa agar setiap email tetap sesuai brand dan pesannya.
Personalisasikan setiap email dengan meneruskan data pelanggan, seperti nama, jumlah, dan ID pembayaran, dalam params.
Uji dalam mode sandbox terlebih dahulu. Keplars menyimpan pengiriman sandbox di Test Inbox-nya, bukan mengirimkannya kepada penerima.

Pemecahan Masalah

Emails not being sent

Pastikan API key Anda benar dan aktif di Keplars pada Settings → API Keys.
Pastikan domain atau alamat pengirim Anda telah diverifikasi.
Di dashboard Dodo Payments, buka pesan tersebut pada tab Logs di 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 tersebut dan pastikan template aktif di dashboard Keplars.

Wrong event triggered

Setiap handler memeriksa webhook.eventType dan mengembalikan webhook tanpa perubahan jika peristiwa tidak cocok. Pastikan Subscribed events pada endpoint hanya mencakup peristiwa yang Anda inginkan.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Kode Transformasi

Email Konfirmasi Pembayaran

Notifikasi Kegagalan Pembayaran

Email Sambutan Subscription

Email Pembatalan Subscription

Tips

Pemecahan Masalah

​Pendahuluan

​Memulai

​Contoh Kode Transformasi

​Email Konfirmasi Pembayaran

​Notifikasi Kegagalan Pembayaran

​Email Sambutan Subscription

​Email Pembatalan Subscription

​Tips

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Kode Transformasi

Email Konfirmasi Pembayaran

Notifikasi Kegagalan Pembayaran

Email Sambutan Subscription

Email Pembatalan Subscription

Tips

Pemecahan Masalah