Resend

Einführung

Die Resend-Integration sendet über Resend eine Transaktions-E-Mail, wenn ein Ereignis in Dodo Payments auftritt. Verwende sie, um Zahlungen zu bestätigen, neue Abonnenten willkommen zu heißen und Kunden über fehlgeschlagene Zahlungen zu informieren – über deine eigene Absenderdomain.

Für diese Integration benötigst du einen Resend API key mit Sending access sowie eine in Resend verifizierte Absenderdomain. Außerdem benötigst du Zugriff auf Developer → Webhooks im Dodo Payments-Dashboard.

Erste Schritte

Open the Webhook Section

Gehen Sie im Dashboard von Dodo Payments zu Developer → Webhooks und klicken Sie auf Add endpoint.

Add endpoint dialog with Resend selected in the Integration dropdown and the How to connect Resend steps

Select Resend

Wähle unter Integration die Option Resend aus. Das Dashboard trägt die Endpoint URL und den Transformationscode für Resend ein. Im Bereich How to connect Resend werden die Einrichtungsschritte angezeigt.

Enter API Key

Öffne in Resend API Keys, klicke auf Create API Key und gib dem Schlüssel Sending access. Resend zeigt den Schlüssel, der mit re_ beginnt, nur einmal an. Füge ihn unter API key ein. Dodo Payments sendet ihn als Bearer-Token im Authorization-Header jeder Anfrage an Resend.

Select Events

Wähle unter Subscribed events nur die Ereignisse aus, die deine Transformation verarbeitet. Ein Ereignis, das von der Transformation unverändert gelassen wird, erreicht Resend im Dodo Payments-Format, und Resend lehnt es ab.

Configure Transformation

Bearbeite unter Transformation code den Handler so, dass jedes abonnierte Ereignis zu einer Resend-E-Mail wird. Beginne mit den Beispielen.

Test & Create

Wähle unter Test this code einen Ereignistyp aus und klicke auf Simulate, um die Anfrage an Resend in der Vorschau anzuzeigen. Klicke anschließend auf Create endpoint.

Done

Dodo Payments sendet jetzt für jedes abonnierte Ereignis eine E-Mail über Resend. Um jede Zustellung und die Antwort von Resend anzuzeigen, öffne den Tab Logs unter Developer → Webhooks.

Beispiele für Transformationscode

Jeder Handler setzt webhook.url auf den Send-email-Endpunkt von Resend und ersetzt webhook.payload durch die E-Mail. Beträge in Dodo Payments werden in der kleinsten Währungseinheit angegeben. Daher teilen die Beispiele durch 100 und zeigen den Währungscode an. Verwende bei Währungen ohne Nachkommastellen wie JPY und KRW den Betrag unverändert.

E-Mail zur Zahlungsbestätigung

Sende eine Quittung, wenn eine Zahlung erfolgreich ist (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;
}

Willkommens-E-Mail für Abonnements

Heiße einen Kunden willkommen, wenn ein Abonnement aktiv wird (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;
}

Benachrichtigung über fehlgeschlagene Zahlungen

Bitte den Kunden, seine Zahlungsmethode zu aktualisieren, wenn eine Zahlung fehlschlägt (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;
}

Tipps

Sende von einer Domain, die du in Resend verifiziert hast, um die Zustellbarkeit zu verbessern.
Füge für jede E-Mail sowohl eine html- als auch eine text-Version ein.
Personalisiere Inhalte mit Kundendaten aus der Payload, z. B. customer.name.
Formuliere Betreffzeilen, die das Ergebnis oder die erforderliche Aktion nennen.
Füge jeder E-Mail, die Marketinginhalte enthält, einen Abmeldelink hinzu.
Sieh dir jede Vorlage mit Simulate in der Vorschau an, bevor du den Endpunkt erstellst.
Um ein Ereignis im Code zu überspringen, setze webhook.cancel = true, bevor du den Webhook zurückgibst. In den Logs wird eine übersprungene Zustellung als erfolgreich protokolliert.

Fehlerbehebung

Emails Not Being Sent

Überprüfe, ob der API key korrekt und aktiv ist und über Sending access verfügt. Um ihn zu ersetzen, bearbeite den Endpunkt und füge unter API key einen neuen Schlüssel ein.
Überprüfe, ob die Absenderdomain in Resend verifiziert ist.
Überprüfe, ob die E-Mail-Adressen der Empfänger gültig sind.
Überprüfe die Versandlimits und Kontingente deines Resend-Tarifs.
Öffne den Tab Logs unter Developer → Webhooks und lies die Antwort von Resend zur fehlgeschlagenen Zustellung.

Transformation Errors

Überprüfe, ob die Payload dem Send-email-Format von Resend entspricht. Resend benötigt from, to und subject.
Überprüfe, ob jedes von deinem Code verarbeitete Ereignis alle erforderlichen Felder setzt.
Überprüfe, ob der Wert von html wohlgeformtes HTML enthält.
Überprüfe, ob die Adresse in from eine in Resend verifizierte Domain verwendet.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Einführung

Erste Schritte

Beispiele für Transformationscode

E-Mail zur Zahlungsbestätigung

Willkommens-E-Mail für Abonnements

Benachrichtigung über fehlgeschlagene Zahlungen

Tipps

Fehlerbehebung

​Einführung

​Erste Schritte

​Beispiele für Transformationscode

​E-Mail zur Zahlungsbestätigung

​Willkommens-E-Mail für Abonnements

​Benachrichtigung über fehlgeschlagene Zahlungen

​Tipps

​Fehlerbehebung

Einführung

Erste Schritte

Beispiele für Transformationscode

E-Mail zur Zahlungsbestätigung

Willkommens-E-Mail für Abonnements

Benachrichtigung über fehlgeschlagene Zahlungen

Tipps

Fehlerbehebung