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 Integration, sélectionnez Keplars. Le modèle renseigne l’URL de l’API Keplars et le code de transformation.

Enter API Key

Collez votre clé API Keplars dans API key. Dodo Payments l’envoie en tant que token Bearer lors de chaque requête. Sous Subscribed events, sélectionnez les événements qui doivent déclencher l’envoi d’un e-mail.

Configure Transformation

Dans Transformation code, modifiez le code pour formater les e-mails destinés à Keplars. Remplacez l’adresse d’expédition et les identifiants 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 haute priorité de Keplars et convertit webhook.payload en requête Keplars. Dodo Payments ajoute la clé API en tant que token Bearer. Remplacez payments@mail.yourdomain.com par votre expéditeur vérifié, puis remplacez your-keplars-*-template-id par vos identifiants de modèle.

to doit être un array, 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],
    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;
}

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

E-mail de bienvenue à 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],
    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 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],
    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;
}

Conseils

Envoyez les 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 respecte votre identité de marque et votre message.
Personnalisez chaque e-mail en transmettant les données client, comme le nom, le montant et l’identifiant du paiement, dans params.
Commencez par effectuer les tests en mode sandbox. Keplars enregistre les envois sandbox dans sa Test Inbox au lieu de les distribuer.

Dépannage

Emails not being sent

Vérifiez que votre clé API est correcte et active dans Keplars, sous Settings → API Keys.
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 Logs de Developer → Webhooks. Chaque tentative de livraison affiche la réponse d’erreur brute de Keplars.

Template not found

Le template_id utilisé dans votre gestionnaire doit correspondre à un modèle actif dans votre compte Keplars. Vérifiez l’identifiant et assurez-vous que le modèle est actif 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 Subscribed events du 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 à 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 à 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 à l’abonnement

E-mail d’annulation de l’abonnement

Conseils

Dépannage