केप्लार्स

परिचय

जब payment और subscription events होते हैं, तब transactional emails अपने-आप भेजें। Payment confirmations, subscription updates और failure notifications बिना middleware server के Keplars के माध्यम से भेजे जाते हैं: Dodo Payments JavaScript transformation handler का उपयोग करके सीधे Keplars API को call करता है।

यह integration आपकी Keplars API key से authenticate होता है। इसे Keplars dashboard में Settings → API Keys के अंतर्गत खोजें और Domains के अंतर्गत sender domain या address verify करें।

आरंभ करें

Open the Webhook Section

Dodo Payments dashboard में Developer → Webhooks पर जाएँ और Add endpoint पर click करें।

Select Keplars

Integration में Keplars चुनें। टेम्पलेट Keplars API URL और transformation code भर देता है।

Integration dropdown में Keplars चयनित वाला Add endpoint संवाद

Enter API Key

अपनी Keplars API key को API key में पेस्ट करें। Dodo Payments इसे हर request पर Bearer token के रूप में भेजता है। Subscribed events के अंतर्गत, वे events चुनें जिन पर email भेजा जाना चाहिए।

Keplars endpoint URL भरा हुआ, API key field और Subscribed events सूची

Configure Transformation

Transformation code में, Keplars के लिए emails को format करने हेतु code को edit करें। Placeholder template IDs को अपने IDs से बदलें।

Test & Create

Test this code के अंतर्गत कोई event type चुनें और sample payload पर transformation चलाने के लिए Simulate पर click करें। फिर emails भेजना शुरू करने के लिए Create endpoint पर click करें।

Done

Dodo Payments events अब Keplars के माध्यम से transactional emails भेजते हैं।

ट्रांसफॉर्मेशन कोड उदाहरण

हर handler webhook.url को Keplars high-priority send endpoint पर सेट करता है और webhook.payload को Keplars request में फिर से लिखता है। Dodo Payments API key को Bearer token के रूप में जोड़ता है। your-keplars-*-template-id को अपने template IDs से बदलें। Keplars send API में from field नहीं है, इसलिए Keplars हर email को उस sender से भेजता है जिसे आपने Keplars dashboard में सेट किया है।

to एक array होना चाहिए, एक recipient के लिए भी। जब आप template_id का उपयोग करें, तो subject या body भी न भेजें, क्योंकि template इन्हें उपलब्ध कराता है।

Payment Confirmation Email

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

Payment Failure Notification

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

Subscription Welcome Email

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

Subscription Cancellation Email

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

सुझाव

Deliverability बेहतर करने के लिए किसी verified domain या address से भेजें।
प्रत्येक event type के लिए एक Keplars template बनाएं, ताकि हर email brand और message के अनुरूप रहे।
params में customer data, जैसे name, amount और payment ID, पास करके हर email को personalize करें।
पहले sandbox mode में test करें। Keplars sandbox sends को deliver करने के बजाय अपने Test Inbox में capture करता है।

समस्या निवारण

Emails not being sent

जाँचें कि आपकी API key सही और Keplars में Settings → API Keys के अंतर्गत active है।
जाँचें कि आपका sender domain या address verified है।
Dodo Payments dashboard में, Developer → Webhooks के Logs tab में message खोलें। प्रत्येक delivery attempt Keplars से प्राप्त raw error response दिखाता है।

Template not found

आपके handler में मौजूद template_id आपके Keplars account में active template से मेल खाना चाहिए। ID जाँचें और Keplars dashboard में जाँचें कि template active है।

Wrong event triggered

प्रत्येक handler webhook.eventType की जाँच करता है और event के मेल न खाने पर webhook को बिना बदलाव के वापस करता है। जाँचें कि endpoint के Subscribed events में केवल वही events शामिल हैं जिन्हें आप चाहते हैं।

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

परिचय

आरंभ करें

ट्रांसफॉर्मेशन कोड उदाहरण

Payment Confirmation Email

Payment Failure Notification

Subscription Welcome Email

Subscription Cancellation Email

सुझाव

समस्या निवारण

​परिचय

​आरंभ करें

​ट्रांसफॉर्मेशन कोड उदाहरण

​Payment Confirmation Email

​Payment Failure Notification

​Subscription Welcome Email

​Subscription Cancellation Email

​सुझाव

​समस्या निवारण

परिचय

आरंभ करें

ट्रांसफॉर्मेशन कोड उदाहरण

Payment Confirmation Email

Payment Failure Notification

Subscription Welcome Email

Subscription Cancellation Email

सुझाव

समस्या निवारण