Keplars

Giới thiệu

Tự động gửi email giao dịch khi xảy ra các sự kiện thanh toán và đăng ký. Email xác nhận thanh toán, cập nhật đăng ký và thông báo thất bại được gửi qua Keplars mà không cần máy chủ middleware: Dodo Payments gọi trực tiếp Keplars API bằng trình xử lý chuyển đổi JavaScript.

Tích hợp này xác thực bằng API key Keplars của bạn. Tìm API key trong dashboard Keplars tại Settings → API Keys, đồng thời xác minh domain hoặc địa chỉ người gửi trong Domains.

Bắt đầu

Open the Webhook Section

Trong dashboard Dodo Payments, đi đến Developer → Webhooks và nhấp vào Add endpoint.

Select Keplars

Trong Integration, chọn Keplars. Mẫu sẽ điền URL Keplars API và mã transformation.

Add endpoint dialog with Keplars selected in the Integration dropdown

Enter API Key

Dán API key Keplars vào API key. Dodo Payments gửi API key này dưới dạng Bearer token trong mọi request. Trong Subscribed events, chọn các sự kiện sẽ gửi email.

Keplars endpoint URL filled in, the API key field, and the Subscribed events list

Configure Transformation

Trong Transformation code, chỉnh sửa mã để định dạng email cho Keplars. Thay thế các template ID giữ chỗ bằng ID của bạn.

Test & Create

Trong Test this code, chọn một loại sự kiện và nhấp vào Simulate để chạy chuyển đổi trên payload mẫu. Sau đó nhấp vào Create endpoint để bắt đầu gửi email.

Done

Các sự kiện Dodo Payments hiện gửi email giao dịch qua Keplars.

Ví dụ về mã chuyển đổi

Mỗi handler đặt webhook.url thành endpoint gửi ưu tiên cao của Keplars và viết lại webhook.payload thành một request đến Keplars. Dodo Payments thêm API key dưới dạng Bearer token. Thay thế your-keplars-*-template-id bằng template ID của bạn. Keplars send API không có trường from, vì vậy Keplars gửi mỗi email từ một sender mà bạn đã thiết lập trong dashboard Keplars.

to phải là một array, ngay cả khi chỉ có một người nhận. Khi sử dụng template_id, không gửi đồng thời subject hoặc body, vì template đã cung cấp các giá trị này.

Email xác nhận thanh toán

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;
}

Thông báo thanh toán thất bại

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 chào mừng đăng ký

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 hủy đăng ký

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;
}

Mẹo

Gửi từ domain hoặc địa chỉ đã được xác minh để cải thiện khả năng gửi email thành công.
Tạo một template Keplars cho mỗi loại sự kiện để mỗi email luôn nhất quán với thương hiệu và thông điệp.
Cá nhân hóa từng email bằng cách truyền dữ liệu khách hàng, chẳng hạn như tên, số tiền và payment ID, trong params.
Trước tiên, hãy kiểm thử ở chế độ sandbox. Keplars ghi nhận các lần gửi trong sandbox vào Test Inbox thay vì gửi chúng đến người nhận.

Khắc phục sự cố

Emails not being sent

Kiểm tra để đảm bảo API key của bạn chính xác và đang hoạt động trong Keplars tại Settings → API Keys.
Kiểm tra để đảm bảo domain hoặc địa chỉ người gửi của bạn đã được xác minh.
Trong dashboard Dodo Payments, mở message trong tab Logs của Developer → Webhooks. Mỗi lần thử gửi đều hiển thị raw error response từ Keplars.

Template not found

template_id trong handler của bạn phải khớp với một template đang hoạt động trong tài khoản Keplars. Kiểm tra ID và xác nhận template đang hoạt động trong dashboard Keplars.

Wrong event triggered

Mỗi handler kiểm tra webhook.eventType và trả về webhook không thay đổi nếu sự kiện không khớp. Kiểm tra để đảm bảo Subscribed events của endpoint chỉ bao gồm các sự kiện bạn muốn.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Giới thiệu

Bắt đầu

Ví dụ về mã chuyển đổi

Email xác nhận thanh toán

Thông báo thanh toán thất bại

Email chào mừng đăng ký

Email hủy đăng ký

Mẹo

Khắc phục sự cố

​Giới thiệu

​Bắt đầu

​Ví dụ về mã chuyển đổi

​Email xác nhận thanh toán

​Thông báo thanh toán thất bại

​Email chào mừng đăng ký

​Email hủy đăng ký

​Mẹo

​Khắc phục sự cố

Giới thiệu

Bắt đầu

Ví dụ về mã chuyển đổi

Email xác nhận thanh toán

Thông báo thanh toán thất bại

Email chào mừng đăng ký

Email hủy đăng ký

Mẹo

Khắc phục sự cố