Resend

Introduction

L’intégration Resend envoie un e-mail transactionnel via Resend lorsqu’un événement Dodo Payments se produit. Utilisez-la pour confirmer les paiements, souhaiter la bienvenue aux nouveaux abonnés et informer les clients lorsqu’un paiement échoue, depuis votre propre domaine d’envoi.

Cette intégration nécessite une clé API Resend avec Sending access et un domaine d’envoi vérifié dans Resend. Vous devez également avoir accès à Developer → Webhooks dans le tableau de bord Dodo Payments.

Prise en main

Open the Webhook Section

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

Fenêtre de dialogue Add endpoint avec Resend sélectionné dans la liste déroulante Integration et les étapes How to connect Resend

Select Resend

Dans Integration, sélectionnez Resend. Le tableau de bord renseigne automatiquement l’Endpoint URL et le code de transformation pour Resend, tandis que le panneau How to connect Resend affiche les étapes de configuration.

Enter API Key

Dans Resend, ouvrez API Keys, cliquez sur Create API Key, puis attribuez à la clé Sending access. Resend n’affiche la clé, qui commence par re_, qu’une seule fois. Collez-la dans API key. Dodo Payments l’envoie comme bearer token dans l’en-tête Authorization de chaque requête vers Resend.

Select Events

Dans Subscribed events, sélectionnez uniquement les événements que votre transformation gère. Un événement laissé inchangé par la transformation parvient à Resend au format Dodo Payments, que Resend rejette.

Configure Transformation

Sous Transformation code, modifiez le handler afin que chaque événement inscrit devienne un e-mail Resend. Commencez avec les exemples.

Test & Create

Sous Test this code, sélectionnez un type d’événement et cliquez sur Simulate pour prévisualiser la requête envoyée à Resend. Cliquez ensuite sur Create endpoint.

Done

Dodo Payments envoie désormais un e-mail via Resend pour chaque événement inscrit. Pour voir chaque livraison et la réponse de Resend, ouvrez l’onglet Logs dans Developer → Webhooks.

Exemples de code de transformation

Chaque handler définit webhook.url sur l’endpoint send-email de Resend et remplace webhook.payload par l’e-mail. Les montants Dodo Payments sont exprimés dans la plus petite unité monétaire. Les exemples les divisent donc par 100 et affichent le code devise. Pour les devises sans décimales, comme JPY et KRW, utilisez le montant tel quel.

E-mail de confirmation de paiement

Envoyez un reçu lorsqu’un paiement réussit (payment.succeeded) :

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.resend.com/emails";
    webhook.payload = {
      from: "payments@yourdomain.com",
      to: [p.customer.email],
      subject: "Payment Confirmation - " + (p.total_amount / 100).toFixed(2) + " " + p.currency,
      html: `
        <h2>Payment Successful!</h2>
        <p>Hi ${p.customer.name},</p>
        <p>Your payment of ${(p.total_amount / 100).toFixed(2)} ${p.currency} has been processed successfully.</p>
        <ul>
          <li><strong>Payment ID:</strong> ${p.payment_id}</li>
          <li><strong>Amount:</strong> ${(p.total_amount / 100).toFixed(2)} ${p.currency}</li>
          <li><strong>Date:</strong> ${new Date(webhook.payload.timestamp).toLocaleDateString()}</li>
          <li><strong>Method:</strong> ${p.payment_method || "Unknown"}</li>
        </ul>
        <p>Thank you for your business!</p>
      `,
      text: `Payment Successful! Your payment of ${(p.total_amount / 100).toFixed(2)} ${p.currency} has been processed. Payment ID: ${p.payment_id}`
    };
  }
  return webhook;
}

E-mail de bienvenue pour un abonnement

Souhaitez la bienvenue à un client lorsqu’un abonnement devient actif (subscription.active) :

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://api.resend.com/emails";
    webhook.payload = {
      from: "welcome@yourdomain.com",
      to: [s.customer.email],
      subject: "Welcome to Your Subscription!",
      html: `
        <h2>Welcome to Your Subscription!</h2>
        <p>Hi ${s.customer.name},</p>
        <p>Your subscription has been activated successfully.</p>
        <ul>
          <li><strong>Subscription ID:</strong> ${s.subscription_id}</li>
          <li><strong>Product:</strong> ${s.product_id}</li>
          <li><strong>Amount:</strong> ${(s.recurring_pre_tax_amount / 100).toFixed(2)} ${s.currency}/${s.payment_frequency_interval}</li>
          <li><strong>Next Billing:</strong> ${new Date(s.next_billing_date).toLocaleDateString()}</li>
        </ul>
        <p>You can manage your subscription anytime from your account dashboard.</p>
      `,
      text: `Welcome! Your subscription is now active. Amount: ${(s.recurring_pre_tax_amount / 100).toFixed(2)} ${s.currency}/${s.payment_frequency_interval}`
    };
  }
  return webhook;
}

Notification d’échec de paiement

Demandez au client de mettre à jour son mode de paiement lorsqu’un paiement échoue (payment.failed) :

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://api.resend.com/emails";
    webhook.payload = {
      from: "support@yourdomain.com",
      to: [p.customer.email],
      subject: "Payment Failed - Action Required",
      html: `
        <h2>Payment Failed</h2>
        <p>Hi ${p.customer.name},</p>
        <p>We were unable to process your payment of ${(p.total_amount / 100).toFixed(2)} ${p.currency}.</p>
        <ul>
          <li><strong>Payment ID:</strong> ${p.payment_id}</li>
          <li><strong>Amount:</strong> ${(p.total_amount / 100).toFixed(2)} ${p.currency}</li>
          <li><strong>Error:</strong> ${p.error_message || "Payment processing failed"}</li>
        </ul>
        <p>Please update your payment method or contact support for assistance.</p>
        <a href="https://yourdomain.com/update-payment">Update Payment Method</a>
      `,
      text: `Payment Failed: We couldn't process your ${(p.total_amount / 100).toFixed(2)} ${p.currency} payment. Please update your payment method.`
    };
  }
  return webhook;
}

Conseils

Envoyez les e-mails depuis un domaine que vous avez vérifié dans Resend afin d’améliorer la délivrabilité.
Incluez une version html et une version text de chaque e-mail.
Personnalisez le contenu avec les données client de la payload, comme customer.name.
Rédigez des objets qui indiquent le résultat ou l’action requise.
Incluez un lien de désabonnement dans tout e-mail contenant du contenu marketing.
Prévisualisez chaque modèle avec Simulate avant de créer l’endpoint.
Pour ignorer un événement dans le code, définissez webhook.cancel = true avant de retourner le webhook. Les logs enregistrent une livraison ignorée comme réussie.

Résolution des problèmes

Emails Not Being Sent

Vérifiez que la clé API est correcte, active et dispose de Sending access. Pour la remplacer, modifiez l’endpoint et collez une nouvelle clé dans API key.
Vérifiez que le domaine de l’expéditeur est vérifié dans Resend.
Vérifiez que les adresses e-mail des destinataires sont valides.
Vérifiez les limites et les quotas d’envoi Resend correspondant à votre forfait.
Ouvrez l’onglet Logs dans Developer → Webhooks et consultez la réponse de Resend concernant la livraison échouée.

Transformation Errors

Vérifiez que la payload correspond au format send-email de Resend. Resend requiert from, to et subject.
Vérifiez que chaque événement géré par votre code définit tous les champs requis.
Vérifiez que la valeur html est du HTML correctement formé.
Vérifiez que l’adresse from utilise un domaine vérifié dans Resend.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Prise en main

Exemples de code de transformation

E-mail de confirmation de paiement

E-mail de bienvenue pour un abonnement

Notification d’échec de paiement

Conseils

Résolution des problèmes

​Introduction

​Prise en main

​Exemples de code de transformation

​E-mail de confirmation de paiement

​E-mail de bienvenue pour un abonnement

​Notification d’échec de paiement

​Conseils

​Résolution des problèmes

Introduction

Prise en main

Exemples de code de transformation

E-mail de confirmation de paiement

E-mail de bienvenue pour un abonnement

Notification d’échec de paiement

Conseils

Résolution des problèmes