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

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

Dialogrutan för att lägga till en slutpunkt med Keplars valt i listrutan Integration

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 e-postmeddelande.

Keplars-slutpunktens URL ifylld, fältet för API-nyckel och listan Subscribed events

Configure Transformation

I Transformation code redigerar du koden för att formatera e-postmeddelanden för Keplars. Ersätt platshållar-ID:na för mallarna 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 handler 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 your-keplars-*-template-id med dina mall-ID:n. Keplars send API har inget fält för from, så Keplars skickar varje e-postmeddelande från en avsändare som du har konfigurerat i Keplars dashboard.

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.

E-postbekräftelse för betalning

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

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],
    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älkomstmeddelande 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],
    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-postmeddelande 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],
    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 e-postmeddelande följer ditt varumärke och budskap.
Anpassa varje e-postmeddelande genom att skicka kunddata, till exempel namn, belopp och betalnings-ID, i params.
Testa i sandbox-läge först. Keplars samlar 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 avsändaradress är verifierad.
Öppna meddelandet på fliken Logs i Developer → Webhooks i Dodo Payments dashboard. Varje leveransförsök visar det råa felsvaret från Keplars.

Template not found

template_id i din handler måste matcha en aktiv mall i ditt Keplars-konto. Kontrollera ID:t och att mallen är aktiv i Keplars dashboard.

Wrong event triggered

Varje handler kontrollerar webhook.eventType och returnerar webhooken oförändrad om händelsen inte matchar. Kontrollera att slutpunktens 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

E-postbekräftelse för betalning

Avisering om misslyckad betalning

Välkomstmeddelande för prenumeration

E-postmeddelande om avslutad prenumeration

Tips

Felsökning

​Introduktion

​Kom igång

​Exempel på transformationskod

​E-postbekräftelse för betalning

​Avisering om misslyckad betalning

​Välkomstmeddelande för prenumeration

​E-postmeddelande om avslutad prenumeration

​Tips

​Felsökning

Introduktion

Kom igång

Exempel på transformationskod

E-postbekräftelse för betalning

Avisering om misslyckad betalning

Välkomstmeddelande för prenumeration

E-postmeddelande om avslutad prenumeration

Tips

Felsökning