Keplars

Introduktion

Skicka transaktionsmejl automatiskt när betalnings- och prenumerationshändelser inträffar. Betalningsbekräftelser, prenumerationsuppdateringar och aviseringar om misslyckanden skickas via Keplars utan någon middleware-server: Dodo Payments anropar Keplars API direkt med hjälp av en JavaScript-transformationshanterare.

Den här integrationen autentiseras med din Keplars API-nyckel. Leta reda på den i Keplars instrumentpanel under Settings → API Keys, och verifiera en avsändardomän eller -adress under Domains.

Kom igång

Open the Webhook Section

Gå till Developer → Webhooks i Dodo Payments instrumentpanel och klicka på Add endpoint.

Select Keplars

Under Integration väljer du Keplars. Mallen fyller i Keplars API-URL och transformationskoden.

Enter API Key

Klistra in din Keplars API-nyckel i API key. Dodo Payments skickar den som en Bearer-token i varje begäran. Under Subscribed events väljer du de händelser som ska skicka ett mejl.

Ange Keplars API-URL och API-nyckel och prenumerera på händelser

Configure Transformation

Under Transformation code redigerar du koden för att formatera mejl för Keplars. Ersätt platshållarens avsändaradress och mall-ID:n med dina egna.

Test & Create

Under Test this code väljer du en händelsetyp och klickar på Simulate för att köra transformationen mot en exempelnyttolast. Klicka sedan på Create endpoint för att börja skicka mejl.

Done

Dodo Payments-händelser skickar nu transaktionsmejl via Keplars.

Exempel på transformationskod

Varje hanterare anger webhook.url till Keplars slutpunkt för högprioriterade utskick och skriver om webhook.payload till en Keplars-begäran. Dodo Payments lägger till API-nyckeln som en Bearer-token. Ersätt payments@mail.yourdomain.com med din verifierade avsändare och ersätt your-keplars-*-template-id med dina mall-ID:n.

to måste vara en array, även för en enda mottagare. När du använder template_id ska du inte också skicka subject eller body, eftersom mallen tillhandahåller dem.

Mejl med betalningsbekräftelse

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

Avisering om misslyckad betalning

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

Välkomstmejl för prenumeration

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

Mejl om avslutad prenumeration

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

Tips

Skicka från en verifierad domän eller adress för att förbättra leveransbarheten.
Skapa en Keplars-mall per händelsetyp så att varje mejl följer ditt varumärke och budskap.
Anpassa varje mejl genom att skicka kunduppgifter, till exempel namn, belopp och betalnings-ID, i params.
Testa i sandbox-läge först. Keplars fångar upp sandbox-utskick i sin Test Inbox i stället för att leverera dem.

Felsökning

Emails not being sent

Kontrollera att din API-nyckel är korrekt och aktiv i Keplars under Settings → API Keys.
Kontrollera att din avsändardomän eller -adress är verifierad.
Öppna meddelandet i fliken Logs under Developer → Webhooks i Dodo Payments instrumentpanel. Varje leveransförsök visar det råa felsvaret från Keplars.

Template not found

template_id i din hanterare måste motsvara en aktiv mall i ditt Keplars-konto. Kontrollera ID:t och att mallen är aktiv i Keplars instrumentpanel.

Wrong event triggered

Varje hanterare kontrollerar webhook.eventType och returnerar webhooken oförändrad om händelsen inte matchar. Kontrollera att endpointens Subscribed events endast innehåller de händelser du vill ha.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduktion

Kom igång

Exempel på transformationskod

Mejl med betalningsbekräftelse

Avisering om misslyckad betalning

Välkomstmejl för prenumeration

Mejl om avslutad prenumeration

Tips

Felsökning

​Introduktion

​Kom igång

​Exempel på transformationskod

​Mejl med betalningsbekräftelse

​Avisering om misslyckad betalning

​Välkomstmejl för prenumeration

​Mejl om avslutad prenumeration

​Tips

​Felsökning

Introduktion

Kom igång

Exempel på transformationskod

Mejl med betalningsbekräftelse

Avisering om misslyckad betalning

Välkomstmejl för prenumeration

Mejl om avslutad prenumeration

Tips

Felsökning