Resend

Introdução

A integração com o Resend envia um email transacional por meio do Resend quando ocorre um evento do Dodo Payments. Use-a para confirmar pagamentos, dar boas-vindas a novos assinantes e informar aos clientes quando um pagamento falhar, usando seu próprio domínio de envio.

Esta integração requer uma chave de API do Resend com Sending access e um domínio de envio verificado no Resend. Você também precisa ter acesso a Developer → Webhooks no dashboard do Dodo Payments.

Começando

Open the Webhook Section

No dashboard do Dodo Payments, acesse Developer → Webhooks e clique em Add endpoint.

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

Select Resend

Em Integration, selecione Resend. O dashboard preenche o Endpoint URL e o código de transformação para o Resend, e o painel How to connect Resend mostra as etapas de configuração.

Enter API Key

No Resend, abra API Keys, clique em Create API Key e conceda à chave Sending access. O Resend exibe a chave, que começa com re_, apenas uma vez. Cole-a em API key. O Dodo Payments a envia como um token bearer no cabeçalho Authorization de cada solicitação ao Resend.

Select Events

Em Subscribed events, selecione apenas os eventos tratados pela sua transformação. Um evento que a transformação deixa inalterado chega ao Resend no formato do Dodo Payments, e o Resend o rejeita.

Configure Transformation

Em Transformation code, edite o handler para que cada evento inscrito se torne um email do Resend. Comece pelos exemplos.

Test & Create

Em Test this code, selecione um tipo de evento e clique em Simulate para visualizar a solicitação enviada ao Resend. Em seguida, clique em Create endpoint.

Done

O Dodo Payments agora envia um email por meio do Resend para cada evento inscrito. Para ver cada entrega e a resposta do Resend, abra a aba Logs em Developer → Webhooks.

Exemplos de código de transformação

Cada handler define webhook.url como o endpoint de envio de emails do Resend e substitui webhook.payload pelo email. Os valores do Dodo Payments estão na menor unidade da moeda, portanto os exemplos dividem por 100 e mostram o código da moeda. Para moedas sem casas decimais, como JPY e KRW, use o valor como está.

Email de confirmação de pagamento

Envie um recibo quando um pagamento for concluído (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 de boas-vindas à assinatura

Dê boas-vindas a um cliente quando uma assinatura se tornar ativa (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ção de falha no pagamento

Peça ao cliente que atualize a forma de pagamento quando um pagamento falhar (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;
}

Dicas

Envie a partir de um domínio que você verificou no Resend, o que melhora a capacidade de entrega.
Inclua uma versão html e uma versão text de cada email.
Personalize o conteúdo com dados do cliente presentes no payload, como customer.name.
Escreva linhas de assunto que indiquem o resultado ou a ação necessária.
Inclua um link de cancelamento de inscrição em qualquer email que contenha conteúdo de marketing.
Visualize cada template com Simulate antes de criar o endpoint.
Para ignorar um evento no código, defina webhook.cancel = true antes de retornar o webhook. Os logs registram uma entrega ignorada como bem-sucedida.

Solução de problemas

Emails Not Being Sent

Verifique se a chave de API está correta, ativa e tem Sending access. Para substituí-la, edite o endpoint e cole uma nova chave em API key.
Verifique se o domínio do remetente está verificado no Resend.
Verifique se os endereços de email dos destinatários são válidos.
Verifique os limites e as cotas de envio do Resend para o seu plano.
Abra a aba Logs em Developer → Webhooks e leia a resposta do Resend para a entrega que falhou.

Transformation Errors

Verifique se o payload corresponde ao formato de envio de emails do Resend. O Resend exige from, to e subject.
Verifique se cada evento tratado pelo seu código define todos os campos obrigatórios.
Verifique se o valor de html é um HTML bem formatado.
Verifique se o endereço de from usa um domínio verificado no Resend.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introdução

Começando

Exemplos de código de transformação

Email de confirmação de pagamento

Email de boas-vindas à assinatura

Notificação de falha no pagamento

Dicas

Solução de problemas

​Introdução

​Começando

​Exemplos de código de transformação

​Email de confirmação de pagamento

​Email de boas-vindas à assinatura

​Notificação de falha no pagamento

​Dicas

​Solução de problemas

Introdução

Começando

Exemplos de código de transformação

Email de confirmação de pagamento

Email de boas-vindas à assinatura

Notificação de falha no pagamento

Dicas

Solução de problemas