Kirim Ulang

Pendahuluan

Integrasi Resend mengirimkan email transaksional melalui Resend saat peristiwa Dodo Payments terjadi. Gunakan integrasi ini untuk mengonfirmasi pembayaran, menyambut pelanggan baru, dan memberi tahu pelanggan saat pembayaran gagal, menggunakan domain pengiriman Anda sendiri.

Integrasi ini memerlukan API key Resend dengan Sending access dan domain pengiriman yang telah diverifikasi di Resend. Anda juga memerlukan akses ke Developer → Webhooks di dashboard Dodo Payments.

Memulai

Open the Webhook Section

Di dashboard Dodo Payments, buka Developer → Webhooks lalu klik Add endpoint.

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

Select Resend

Di Integration, pilih Resend. Dashboard akan mengisi Endpoint URL dan kode transformasi untuk Resend, sementara panel How to connect Resend menampilkan langkah-langkah penyiapan.

Enter API Key

Di Resend, buka API Keys, klik Create API Key, lalu berikan key tersebut Sending access. Resend menampilkan key yang diawali dengan re_ hanya sekali. Tempelkan key tersebut ke API key. Dodo Payments mengirimkannya sebagai bearer token dalam header Authorization pada setiap request ke Resend.

Select Events

Di Subscribed events, pilih hanya peristiwa yang ditangani oleh transformasi Anda. Peristiwa yang dibiarkan tidak berubah oleh transformasi akan diteruskan ke Resend dalam format Dodo Payments, dan Resend akan menolaknya.

Configure Transformation

Di bagian Transformation code, edit handler agar setiap peristiwa yang dipilih menjadi email Resend. Mulailah dari contoh.

Test & Create

Di bagian Test this code, pilih jenis peristiwa, lalu klik Simulate untuk melihat pratinjau request ke Resend. Setelah itu, klik Create endpoint.

Done

Dodo Payments kini mengirimkan email melalui Resend untuk setiap peristiwa yang dipilih. Untuk melihat setiap pengiriman dan respons Resend, buka tab Logs di Developer → Webhooks.

Contoh Kode Transformasi

Setiap handler menetapkan webhook.url ke endpoint send-email Resend dan mengganti webhook.payload dengan email tersebut. Jumlah Dodo Payments menggunakan unit mata uang terkecil, jadi contoh-contoh ini membaginya dengan 100 dan menampilkan kode mata uang. Untuk mata uang tanpa angka desimal seperti JPY dan KRW, gunakan jumlah tersebut apa adanya.

Email Konfirmasi Pembayaran

Kirim tanda terima saat pembayaran berhasil (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 Ucapan Selamat Datang untuk Subscription

Sambut pelanggan saat subscription menjadi aktif (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;
}

Pemberitahuan Kegagalan Pembayaran

Minta pelanggan memperbarui metode pembayaran mereka saat pembayaran gagal (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;
}

Tips

Kirim dari domain yang telah Anda verifikasi di Resend untuk meningkatkan deliverability.
Sertakan versi html dan versi text untuk setiap email.
Personalisasikan konten dengan data pelanggan dari payload, seperti customer.name.
Tulis subjek yang menyatakan hasil atau tindakan yang diperlukan.
Sertakan tautan berhenti berlangganan dalam email apa pun yang berisi konten marketing.
Pratinjau setiap template dengan Simulate sebelum membuat endpoint.
Untuk melewati suatu peristiwa dalam kode, tetapkan webhook.cancel = true sebelum mengembalikan webhook. Log mencatat pengiriman yang dilewati sebagai berhasil.

Pemecahan Masalah

Emails Not Being Sent

Periksa bahwa API key sudah benar, aktif, dan memiliki Sending access. Untuk menggantinya, edit endpoint, lalu tempelkan key baru di API key.
Periksa bahwa domain pengirim telah diverifikasi di Resend.
Periksa bahwa alamat email penerima valid.
Periksa batas dan kuota pengiriman Resend untuk paket Anda.
Buka tab Logs di Developer → Webhooks, lalu baca respons Resend terhadap pengiriman yang gagal.

Transformation Errors

Periksa bahwa payload sesuai dengan format send-email Resend. Resend memerlukan from, to, dan subject.
Periksa bahwa setiap peristiwa yang ditangani kode Anda menetapkan semua field yang diperlukan.
Periksa bahwa nilai html merupakan HTML yang valid.
Periksa bahwa alamat from menggunakan domain yang telah diverifikasi di Resend.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Kode Transformasi

Email Konfirmasi Pembayaran

Email Ucapan Selamat Datang untuk Subscription

Pemberitahuan Kegagalan Pembayaran

Tips

Pemecahan Masalah

​Pendahuluan

​Memulai

​Contoh Kode Transformasi

​Email Konfirmasi Pembayaran

​Email Ucapan Selamat Datang untuk Subscription

​Pemberitahuan Kegagalan Pembayaran

​Tips

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Kode Transformasi

Email Konfirmasi Pembayaran

Email Ucapan Selamat Datang untuk Subscription

Pemberitahuan Kegagalan Pembayaran

Tips

Pemecahan Masalah