Keplars

Introduction

Envoyez automatiquement des e-mails transactionnels lorsque des événements de paiement et d’abonnement surviennent. Les confirmations de paiement, les mises à jour d’abonnement et les notifications d’échec sont envoyées via Keplars sans serveur middleware : Dodo Payments appelle directement l’API Keplars à l’aide d’un gestionnaire de transformation JavaScript.

Cette intégration s’authentifie avec votre clé API Keplars. Retrouvez-la dans le tableau de bord Keplars sous Settings → API Keys, puis vérifiez un domaine ou une adresse d’expédition sous Domains.

Démarrage

Open the Webhook Section

Dans le tableau de bord Dodo Payments, accédez à Developer → Webhooks et cliquez sur Add endpoint.

Select Keplars

Dans Intégration, sélectionnez Keplars. Le modèle renseigne l’URL de l’API Keplars et le code de transformation.

Boîte de dialogue d’ajout d’un endpoint avec Keplars sélectionné dans la liste déroulante Intégration

Enter API Key

Collez votre clé API Keplars dans Clé API. Dodo Payments l’envoie sous forme de Bearer token dans chaque requête. Sous Événements abonnés, sélectionnez les événements qui doivent envoyer un e-mail.

URL de l’endpoint Keplars renseignée, champ de clé API et liste des événements abonnés

Configure Transformation

Dans Code de transformation, modifiez le code pour mettre en forme les e-mails destinés à Keplars. Remplacez les ID de modèle fictifs par les vôtres.

Test & Create

Sous Test this code, sélectionnez un type d’événement et cliquez sur Simulate pour exécuter la transformation avec un exemple de payload. Cliquez ensuite sur Create endpoint pour commencer à envoyer des e-mails.

Done

Les événements Dodo Payments envoient désormais des e-mails transactionnels via Keplars.

Exemples de Code de Transformation

Chaque gestionnaire définit webhook.url sur l’endpoint d’envoi prioritaire de Keplars et réécrit webhook.payload en requête Keplars. Dodo Payments ajoute la clé API en tant que Bearer token. Remplacez your-keplars-*-template-id par vos ID de modèle. L’API d’envoi de Keplars ne possède pas de champ from ; Keplars envoie donc chaque e-mail depuis un expéditeur que vous avez configuré dans le tableau de bord Keplars.

to doit être un tableau, même pour un seul destinataire. Lorsque vous utilisez template_id, n’envoyez pas également subject ou body, car le modèle les fournit.

E-mail de confirmation du paiement

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

Notification d’échec du paiement

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

E-mail de bienvenue pour l’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 d’annulation de l’abonnement

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

Conseils

Envoyez vos e-mails depuis un domaine ou une adresse vérifié(e) pour améliorer la délivrabilité.
Créez un modèle Keplars par type d’événement afin que chaque e-mail reste conforme à votre image et à votre message.
Personnalisez chaque e-mail en transmettant les données du client, telles que son nom, le montant et l’ID du paiement, dans params.
Commencez par effectuer des tests en mode sandbox. Keplars enregistre les envois sandbox dans sa boîte de réception de test au lieu de les distribuer.

Dépannage

Emails not being sent

Vérifiez que votre clé API est correcte et active dans Keplars, sous Paramètres → Clés API.
Vérifiez que votre domaine ou adresse d’expédition est vérifié(e).
Dans le tableau de bord Dodo Payments, ouvrez le message dans l’onglet Journaux de Développeur → Webhooks. Chaque tentative de livraison affiche la réponse d’erreur brute de Keplars.

Template not found

Le template_id dans votre gestionnaire doit correspondre à un modèle actif dans votre compte Keplars. Vérifiez l’ID ainsi que l’activation du modèle dans le tableau de bord Keplars.

Wrong event triggered

Chaque gestionnaire vérifie webhook.eventType et renvoie le webhook sans modification si l’événement ne correspond pas. Vérifiez que les Événements abonnés de l’endpoint incluent uniquement les événements souhaités.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Démarrage

Exemples de Code de Transformation

E-mail de confirmation du paiement

Notification d’échec du paiement

E-mail de bienvenue pour l’abonnement

E-mail d’annulation de l’abonnement

Conseils

Dépannage

​Introduction

​Démarrage

​Exemples de Code de Transformation

​E-mail de confirmation du paiement

​Notification d’échec du paiement

​E-mail de bienvenue pour l’abonnement

​E-mail d’annulation de l’abonnement

​Conseils

​Dépannage

Introduction

Démarrage

Exemples de Code de Transformation

E-mail de confirmation du paiement

Notification d’échec du paiement

E-mail de bienvenue pour l’abonnement

E-mail d’annulation de l’abonnement

Conseils

Dépannage