Keplars

Einführung

Versenden Sie automatisch transaktionale E-Mails, wenn Zahlungs- und Abonnementereignisse auftreten. Zahlungsbestätigungen, Aktualisierungen von Abonnements und Benachrichtigungen über fehlgeschlagene Zahlungen werden über Keplars versendet – ganz ohne Middleware-Server: Dodo Payments ruft die Keplars API direkt auf und verwendet dabei einen JavaScript-Transformations-Handler.

Diese Integration authentifiziert sich mit Ihrem Keplars API-Schlüssel. Sie finden ihn im Keplars-Dashboard unter Settings → API Keys. Verifizieren Sie außerdem eine Absenderdomain oder -adresse unter Domains.

Erste Schritte

Open the Webhook Section

Gehen Sie im Dodo Payments-Dashboard zu Developer → Webhooks und klicken Sie auf Add endpoint.

Select Keplars

Wähle unter Integration Keplars aus. Die Vorlage trägt die Keplars API-URL und den Transformationscode ein.

Dialog zum Hinzufügen eines Endpunkts mit ausgewähltem Keplars im Dropdown-Menü Integration

Enter API Key

Füge deinen Keplars API-Schlüssel unter API key ein. Dodo Payments sendet ihn bei jeder Anfrage als Bearer-Token. Wähle unter Subscribed events die Ereignisse aus, die eine E-Mail senden sollen.

Ausgefüllte Keplars-Endpunkt-URL, das Feld für den API-Schlüssel und die Liste Subscribed events

Configure Transformation

Bearbeite unter Transformation code den Code, um E-Mails für Keplars zu formatieren. Ersetze die Platzhalter für die Vorlagen-IDs durch deine eigenen.

Test & Create

Wählen Sie unter Test this code einen Ereignistyp aus und klicken Sie auf Simulate, um die Transformation anhand einer Beispiel-Payload auszuführen. Klicken Sie anschließend auf Create endpoint, um mit dem Versand von E-Mails zu beginnen.

Done

Dodo Payments-Ereignisse versenden jetzt transaktionale E-Mails über Keplars.

Transformationscode-Beispiele

Jeder Handler setzt webhook.url auf den Keplars-Endpunkt zum Senden mit hoher Priorität und schreibt webhook.payload in eine Keplars-Anfrage um. Dodo Payments fügt den API-Schlüssel als Bearer-Token hinzu. Ersetze your-keplars-*-template-id durch deine Vorlagen-IDs. Die Keplars Send API verfügt über kein Feld from, daher sendet Keplars jede E-Mail über einen Absender, den du im Keplars-Dashboard eingerichtet hast.

to muss ein Array sein, auch bei nur einem Empfänger. Wenn du template_id verwendest, darfst du nicht zusätzlich subject oder body senden, da die Vorlage diese Werte bereitstellt.

E-Mail zur Zahlungsbestätigung

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

Benachrichtigung über fehlgeschlagene Zahlung

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

Willkommens-E-Mail für das Abonnement

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

E-Mail zur Kündigung des Abonnements

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

Tipps

Sende von einer verifizierten Domain oder Adresse, um die Zustellbarkeit zu verbessern.
Erstelle eine Keplars-Vorlage pro Ereignistyp, damit jede E-Mail markengerecht und mit der richtigen Botschaft bleibt.
Personalisiere jede E-Mail, indem du in params Kundendaten wie Name, Betrag und Zahlungs-ID übergibst.
Teste zuerst im Sandbox-Modus. Keplars erfasst Sandbox-Sendungen in seiner Test Inbox, anstatt sie zuzustellen.

Fehlerbehebung

Emails not being sent

Überprüfe, ob dein API-Schlüssel in Keplars unter Settings → API Keys korrekt und aktiv ist.
Überprüfe, ob deine Absenderdomain oder -adresse verifiziert ist.
Öffne im Dodo Payments-Dashboard die Nachricht im Tab Logs unter Developer → Webhooks. Jeder Zustellversuch zeigt die unformatierte Fehlerantwort von Keplars.

Template not found

Der template_id in deinem Handler muss mit einer aktiven Vorlage in deinem Keplars-Konto übereinstimmen. Überprüfe die ID und im Keplars-Dashboard, ob die Vorlage aktiv ist.

Wrong event triggered

Jeder Handler überprüft webhook.eventType und gibt den Webhook unverändert zurück, wenn das Ereignis nicht übereinstimmt. Überprüfe, ob unter Subscribed events des Endpunkts nur die gewünschten Ereignisse aufgeführt sind.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Einführung

Erste Schritte

Transformationscode-Beispiele

E-Mail zur Zahlungsbestätigung

Benachrichtigung über fehlgeschlagene Zahlung

Willkommens-E-Mail für das Abonnement

E-Mail zur Kündigung des Abonnements

Tipps

Fehlerbehebung

​Einführung

​Erste Schritte

​Transformationscode-Beispiele

​E-Mail zur Zahlungsbestätigung

​Benachrichtigung über fehlgeschlagene Zahlung

​Willkommens-E-Mail für das Abonnement

​E-Mail zur Kündigung des Abonnements

​Tipps

​Fehlerbehebung

Einführung

Erste Schritte

Transformationscode-Beispiele

E-Mail zur Zahlungsbestätigung

Benachrichtigung über fehlgeschlagene Zahlung

Willkommens-E-Mail für das Abonnement

E-Mail zur Kündigung des Abonnements

Tipps

Fehlerbehebung