Langsung ke konten utama

​
Pendahuluan

Integrasi AutoSend dan Dodo Payments memungkinkan Anda untuk secara otomatis mengirim notifikasi email waktu nyata untuk semua peristiwa pembayaran, mulai dari transaksi yang berhasil hingga upaya yang gagal dan konfirmasi pengembalian dana. Kirim email transaksi untuk peristiwa pembayaran menggunakan API email kuat dari AutoSend.
Integrasi ini membutuhkan Kunci API AutoSend Anda untuk otentikasi. Anda dapat menemukan kunci API Anda di dashboard AutoSend di bawah Settings > API Keys.

​
Memulai

Ikuti langkah-langkah ini untuk mengintegrasikan AutoSend dengan Dodo Payments:
1

Open Webhook Section

Navigasikan ke bagian Webhooks di dashboard Dodo Payments Anda.
Tambahkan menu tarik-turun Endpoint dan integrasi
2

Select AutoSend Integration

Pilih AutoSend dari daftar integrasi yang tersedia.
3

Enter API Key

Masukkan kunci API AutoSend Anda untuk otentikasi. Anda dapat menemukan kunci API di dashboard AutoSend di bawah Settings > API Keys.

Learn how to create and manage API keys

Kunjungi dokumentasi AutoSend untuk petunjuk terperinci tentang cara membuat dan mengelola kunci API.
4

Configure Transformation

Atur handler transformasi JavaScript untuk menyesuaikan konten email berdasarkan event pembayaran.
5

Test & Create

Uji konfigurasi webhook Anda untuk memastikan email dikirim dengan benar, lalu buat integrasi tersebut.
6

Activation Complete

🎉 Integrasi AutoSend Anda sekarang aktif dan akan secara otomatis mengirim email untuk event pembayaran yang telah dikonfigurasi.

​
Contoh Kode

​
Email Konfirmasi Pembayaran

Kirim email konfirmasi ketika pembayaran berhasil diproses:
payment_confirmation.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "payments@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Payment Successful - Thank you for your purchase!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        paymentId: p.payment_id,
        paymentDate: new Date(p.created_at).toLocaleDateString(),
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

​
Email Selamat Datang Langganan

Kirim email selamat datang ketika langganan baru dibuat:
subscription_welcome.js
function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: s.customer.email,
        name: s.customer.name,
      },
      from: {
        email: "subscriptions@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Welcome to your subscription!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: s.customer.name,
        planName: s.plan.name,
        billingInterval: s.billing_interval,
        nextBillingDate: new Date(s.next_billing_at).toLocaleDateString(),
        subscriptionId: s.subscription_id,
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

​
Notifikasi Kegagalan Pembayaran

Kirim email notifikasi ketika pembayaran gagal:
payment_failure.js
function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "billing@mail.yourdomain.com",
        name: "Your Company Billing",
      },
      subject: "Payment Failed - Action Required",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        failureReason: p.failure_reason,
        paymentId: p.payment_id,
        retryUrl: `https://yourdomain.com/billing/retry/${p.payment_id}`,
      },
      replyTo: {
        email: "billing@yourdomain.com",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

​
Praktik Terbaik

  • Verifikasi domain pengirim Anda: Pastikan domain email pengirim Anda terverifikasi di AutoSend untuk meningkatkan pengiriman dan menghindari masalah otentikasi. Domain yang terverifikasi membantu mencegah email masuk ke folder spam.
  • Gunakan data dinamis untuk personalisasi: Gunakan field dynamicData untuk mempersonalisasi email dengan informasi spesifik pelanggan seperti nama, jumlah pembayaran, dan detail langganan. Email yang dipersonalisasi memiliki tingkat keterlibatan yang lebih tinggi.
  • Tulis subjek yang jelas: Tulis subjek deskriptif yang jelas menunjukkan tujuan email. Hindari kata-kata yang memicu spam dan jaga subjek tetap singkat (di bawah 50 karakter).
  • Uji sebelum produksi: Selalu uji email Anda sebelum mengirimnya dalam produksi. Ini memastikan konten email Anda dirender dengan benar dan semua data dinamis dipetakan dengan baik.

​
Referensi API

Untuk detail lengkap tentang API AutoSend, termasuk semua parameter yang tersedia dan kode kesalahan, kunjungi Dokumentasi API AutoSend.

​
Pemecahan Masalah

  • Verifikasi bahwa Kunci API benar dan aktif
  • Pastikan domain pengirim terverifikasi di AutoSend
  • Pastikan alamat email penerima valid
  • Tinjau batas pengiriman dan kuota AutoSend
  • Verifikasi bahwa URL endpoint API benar: https://api.autosend.com/v1/mails/send
  • Periksa bahwa parameter yang diperlukan hadir dalam payload
  • Validasi struktur JSON sesuai format API AutoSend
  • Periksa bahwa semua field yang diperlukan hadir (to, from, templateId atau html/text)
  • Pastikan alamat email diformat dengan benar
  • Verifikasi templateId valid jika menggunakan template
  • Periksa bahwa kunci dynamicData sesuai dengan variabel template Anda
  • Verifikasi bahwa ID template Anda benar dan aktif di AutoSend
  • Pastikan kunci dynamicData sesuai dengan variabel yang digunakan dalam template Anda
  • Periksa bahwa semua variabel template yang diperlukan tersedia
  • Uji template Anda secara mandiri di dashboard AutoSend