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. Template sẽ tự điền URL Keplars API và mã chuyển đổi.

Enter API Key

Dán API key Keplars vào API key. Dodo Payments gửi 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.

Nhập URL Keplars API, API Key và đăng ký các sự kiện

Configure Transformation

Trong Transformation code, chỉnh sửa mã để định dạng email cho Keplars. Thay địa chỉ người gửi giữ chỗ và template ID bằng thông tin 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à chuyển đổi webhook.payload thành request Keplars. Dodo Payments thêm API key dưới dạng Bearer token. Thay payments@mail.yourdomain.com bằng người gửi đã xác minh của bạn, và thay your-keplars-*-template-id bằng template ID của bạn.

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 thêm 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],
    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;
}

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

Mẹo

Gửi từ domain hoặc địa chỉ đã xác minh để cải thiện khả năng gửi đến hộp thư.
Tạo một template Keplars cho mỗi loại sự kiện để từng 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 tra trong sandbox mode. Keplars ghi nhận các lần gửi sandbox trong Test Inbox thay vì gửi đế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ị phản hồi lỗi thô từ Keplars.

Template not found

template_id trong handler của bạn phải khớp với template đang hoạt động trong tài khoản Keplars. Kiểm tra ID và đảm bảo 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ố