Resend

Introduzione

L’integrazione con Resend invia un’email transazionale tramite Resend quando si verifica un evento di Dodo Payments. Usala per confermare i pagamenti, dare il benvenuto ai nuovi abbonati e informare i clienti quando un pagamento non va a buon fine, utilizzando il tuo dominio di invio.

Questa integrazione richiede una chiave API di Resend con Sending access e un dominio di invio verificato in Resend. Devi inoltre avere accesso a Developer → Webhooks nella dashboard di Dodo Payments.

Iniziare

Open the Webhook Section

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

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

Select Resend

In Integration, seleziona Resend. La dashboard compila Endpoint URL e il codice di trasformazione per Resend, mentre il pannello How to connect Resend mostra i passaggi di configurazione.

Enter API Key

In Resend, apri API Keys, fai clic su Create API Key e assegna alla chiave Sending access. Resend mostra la chiave, che inizia con re_, una sola volta. Incollala in API key. Dodo Payments la invia come bearer token nell’header Authorization di ogni richiesta a Resend.

Select Events

In Subscribed events, seleziona solo gli eventi gestiti dalla tua trasformazione. Un evento che la trasformazione lascia invariato arriva a Resend nel formato di Dodo Payments, e Resend lo rifiuta.

Configure Transformation

In Transformation code, modifica l’handler in modo che ogni evento sottoscritto diventi un’email Resend. Inizia dagli esempi.

Test & Create

In Test this code, seleziona un tipo di evento e fai clic su Simulate per visualizzare in anteprima la richiesta a Resend. Quindi fai clic su Create endpoint.

Done

Dodo Payments ora invia un’email tramite Resend per ogni evento sottoscritto. Per visualizzare ogni invio e la risposta di Resend, apri la scheda Logs in Developer → Webhooks.

Esempi di codice di trasformazione

Ogni handler imposta webhook.url sull’endpoint send-email di Resend e sostituisce webhook.payload con l’email. Gli importi di Dodo Payments sono espressi nell’unità monetaria più piccola, quindi gli esempi li dividono per 100 e mostrano il codice della valuta. Per le valute senza decimali, come JPY e KRW, usa l’importo così com’è.

Email di conferma del pagamento

Invia una ricevuta quando un pagamento va a buon fine (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;
}

Email di benvenuto per l’abbonamento

Dai il benvenuto a un cliente quando un abbonamento diventa attivo (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;
}

Notifica di pagamento non riuscito

Chiedi al cliente di aggiornare il metodo di pagamento quando un pagamento non va a buon fine (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;
}

Suggerimenti

Invia da un dominio che hai verificato in Resend, in modo da migliorare la deliverability.
Includi una versione html e una versione text di ogni email.
Personalizza i contenuti con i dati del cliente presenti nel payload, come customer.name.
Scrivi oggetti che indichino il risultato o l’azione richiesta.
Includi un link per annullare l’iscrizione in qualsiasi email che contenga contenuti di marketing.
Visualizza in anteprima ogni template con Simulate prima di creare l’endpoint.
Per ignorare un evento nel codice, imposta webhook.cancel = true prima di restituire il webhook. I log registrano un invio ignorato come riuscito.

Risoluzione dei problemi

Emails Not Being Sent

Verifica che la chiave API sia corretta, attiva e disponga di Sending access. Per sostituirla, modifica l’endpoint e incolla una nuova chiave in API key.
Verifica che il dominio del mittente sia verificato in Resend.
Verifica che gli indirizzi email dei destinatari siano validi.
Verifica i limiti e le quote di invio di Resend per il tuo piano.
Apri la scheda Logs in Developer → Webhooks e leggi la risposta di Resend relativa all’invio non riuscito.

Transformation Errors

Verifica che il payload corrisponda al formato send-email di Resend. Resend richiede from, to e subject.
Verifica che ogni evento gestito dal codice imposti tutti i campi obbligatori.
Verifica che il valore html sia HTML valido.
Verifica che l’indirizzo from utilizzi un dominio verificato in Resend.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduzione

Iniziare

Esempi di codice di trasformazione

Email di conferma del pagamento

Email di benvenuto per l’abbonamento

Notifica di pagamento non riuscito

Suggerimenti

Risoluzione dei problemi

​Introduzione

​Iniziare

​Esempi di codice di trasformazione

​Email di conferma del pagamento

​Email di benvenuto per l’abbonamento

​Notifica di pagamento non riuscito

​Suggerimenti

​Risoluzione dei problemi

Introduzione

Iniziare

Esempi di codice di trasformazione

Email di conferma del pagamento

Email di benvenuto per l’abbonamento

Notifica di pagamento non riuscito

Suggerimenti

Risoluzione dei problemi