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ählen Sie unter Integration die Option Keplars aus. Die Vorlage trägt die Keplars API-URL und den Transformationscode automatisch ein.

Wählen Sie die Keplars-Integrationskarte aus

Enter API Key

Fügen Sie Ihren Keplars API-Schlüssel in API key ein. Dodo Payments sendet ihn bei jeder Anfrage als Bearer-Token. Wählen Sie unter Subscribed events die Ereignisse aus, die eine E-Mail auslösen sollen.

Geben Sie die Keplars API-URL und den API-Schlüssel ein und abonnieren Sie Ereignisse

Configure Transformation

Bearbeiten Sie unter Transformation code den Code, um E-Mails für Keplars zu formatieren. Ersetzen Sie die Platzhalter für die Absenderadresse und die Vorlagen-IDs durch Ihre eigenen Werte.

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 für den Versand mit hoher Priorität und wandelt webhook.payload in eine Keplars-Anfrage um. Dodo Payments fügt den API-Schlüssel als Bearer-Token hinzu. Ersetzen Sie payments@mail.yourdomain.com durch Ihren verifizierten Absender und your-keplars-*-template-id durch Ihre Vorlagen-IDs.

to muss ein Array sein, auch bei nur einem Empfänger. Wenn Sie template_id verwenden, dürfen Sie 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],
    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;
}

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

Willkommens-E-Mail für Abonnements

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

E-Mail zur Kündigung eines 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],
    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;
}

Tipps

Senden Sie von einer verifizierten Domain oder Adresse, um die Zustellbarkeit zu verbessern.
Erstellen Sie eine Keplars-Vorlage pro Ereignistyp, damit jede E-Mail markengerecht und inhaltlich passend bleibt.
Personalisieren Sie jede E-Mail, indem Sie Kundendaten wie Name, Betrag und Zahlungs-ID in params übergeben.
Testen Sie zunächst im Sandbox-Modus. Keplars erfasst Sandbox-Nachrichten im Testeingang, anstatt sie zuzustellen.

Fehlerbehebung

Emails not being sent

Überprüfen Sie, ob Ihr API-Schlüssel in Keplars unter Settings → API Keys korrekt und aktiv ist.
Überprüfen Sie, ob Ihre Absenderdomain oder -adresse verifiziert ist.
Öffnen Sie im Dodo Payments-Dashboard die Nachricht im Tab Logs unter Developer → Webhooks. Jeder Zustellversuch zeigt die unveränderte Fehlerantwort von Keplars.

Template not found

Der template_id in Ihrem Handler muss einer aktiven Vorlage in Ihrem Keplars-Konto entsprechen. Überprüfen Sie die ID und im Keplars-Dashboard, ob die Vorlage aktiv ist.

Wrong event triggered

Jeder Handler prüft webhook.eventType und gibt den Webhook unverändert zurück, wenn das Ereignis nicht übereinstimmt. Überprüfen Sie, ob Subscribed events des Endpunkts nur die gewünschten Ereignisse enthalten.

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 Abonnements

E-Mail zur Kündigung eines Abonnements

Tipps

Fehlerbehebung

​Einführung

​Erste Schritte

​Transformationscode-Beispiele

​E-Mail zur Zahlungsbestätigung

​Benachrichtigung über fehlgeschlagene Zahlung

​Willkommens-E-Mail für Abonnements

​E-Mail zur Kündigung eines Abonnements

​Tipps

​Fehlerbehebung

Einführung

Erste Schritte

Transformationscode-Beispiele

E-Mail zur Zahlungsbestätigung

Benachrichtigung über fehlgeschlagene Zahlung

Willkommens-E-Mail für Abonnements

E-Mail zur Kündigung eines Abonnements

Tipps

Fehlerbehebung