Keplars

Introduzione

Invia automaticamente email transazionali quando si verificano eventi di pagamento e abbonamento. Le conferme di pagamento, gli aggiornamenti degli abbonamenti e le notifiche di errore vengono inviate tramite Keplars senza un server middleware: Dodo Payments chiama direttamente l’API di Keplars utilizzando un gestore di trasformazione JavaScript.

Questa integrazione esegue l’autenticazione con la tua API key di Keplars. Puoi trovarla nella dashboard di Keplars in Settings → API Keys e verificare un dominio o un indirizzo del mittente in Domains.

Iniziare

Open the Webhook Section

Nella dashboard di Dodo Payments, vai su Developer → Webhooks e fai clic su Add endpoint.

Select Keplars

In Integration, seleziona Keplars. Il template compila l’URL API di Keplars e il codice di trasformazione.

Finestra di dialogo per l'aggiunta di un endpoint con Keplars selezionato nel menu a discesa Integration

Enter API Key

Incolla la chiave API di Keplars in API key. Dodo Payments la invia come token Bearer in ogni richiesta. In Subscribed events, seleziona gli eventi che devono inviare un’email.

URL dell'endpoint Keplars compilato, campo della chiave API ed elenco Subscribed events

Configure Transformation

In Transformation code, modifica il codice per formattare le email per Keplars. Sostituisci gli ID template segnaposto con i tuoi.

Test & Create

In Test this code, seleziona un tipo di evento e fai clic su Simulate per eseguire la trasformazione su un payload di esempio. Fai quindi clic su Create endpoint per iniziare a inviare email.

Done

Gli eventi di Dodo Payments ora inviano email transazionali tramite Keplars.

Esempi di Codice per la Trasformazione

Ogni handler imposta webhook.url sull’endpoint di invio ad alta priorità di Keplars e riscrive webhook.payload in una richiesta Keplars. Dodo Payments aggiunge la chiave API come token Bearer. Sostituisci your-keplars-*-template-id con i tuoi ID template. L’API di invio di Keplars non dispone del campo from, quindi Keplars invia ogni email da un mittente configurato nella dashboard di Keplars.

to deve essere un array, anche per un singolo destinatario. Quando usi template_id, non inviare anche subject o body, perché li fornisce il template.

Email di conferma del pagamento

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

Notifica di pagamento non riuscito

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

Email di benvenuto per l’abbonamento

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

Email di annullamento dell’abbonamento

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

Suggerimenti

Invia da un dominio o indirizzo verificato per migliorare la recapitabilità.
Crea un template Keplars per ogni tipo di evento, così ogni email rimane coerente con il brand e con il messaggio.
Personalizza ogni email passando i dati del cliente, ad esempio nome, importo e ID del pagamento, in params.
Esegui prima i test in modalità sandbox. Keplars acquisisce gli invii sandbox nella propria Test Inbox invece di recapitarli.

Risoluzione dei problemi

Emails not being sent

Verifica che la chiave API sia corretta e attiva in Keplars, in Settings → API Keys.
Verifica che il dominio o l’indirizzo del mittente siano verificati.
Nella dashboard di Dodo Payments, apri il messaggio nella scheda Logs di Developer → Webhooks. Ogni tentativo di consegna mostra la risposta di errore non elaborata di Keplars.

Template not found

template_id nel tuo handler deve corrispondere a un template attivo nel tuo account Keplars. Controlla l’ID e verifica che il template sia attivo nella dashboard di Keplars.

Wrong event triggered

Ogni handler controlla webhook.eventType e restituisce il webhook invariato se l’evento non corrisponde. Verifica che gli Subscribed events dell’endpoint includano solo gli eventi desiderati.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduzione

Iniziare

Esempi di Codice per la Trasformazione

Email di conferma del pagamento

Notifica di pagamento non riuscito

Email di benvenuto per l’abbonamento

Email di annullamento dell’abbonamento

Suggerimenti

Risoluzione dei problemi

​Introduzione

​Iniziare

​Esempi di Codice per la Trasformazione

​Email di conferma del pagamento

​Notifica di pagamento non riuscito

​Email di benvenuto per l’abbonamento

​Email di annullamento dell’abbonamento

​Suggerimenti

​Risoluzione dei problemi

Introduzione

Iniziare

Esempi di Codice per la Trasformazione

Email di conferma del pagamento

Notifica di pagamento non riuscito

Email di benvenuto per l’abbonamento

Email di annullamento dell’abbonamento

Suggerimenti

Risoluzione dei problemi