Add-ons untuk Langganan

Add-on adalah produk tambahan yang dilampirkan ke langganan. Pelanggan memilih kuantitas saat checkout atau ketika memperbarui langganan mereka, dan add-on ditagihkan mengikuti siklus langganan induk.

Seat-Based Billing

Buat add-on untuk seat tim tambahan atau lisensi pengguna.

Usage Extensions

Perluas batas penggunaan, panggilan API, atau alokasi data dengan add-on.

Apa Itu Add-on?

Add-on adalah produk tambahan yang dapat dibeli pelanggan bersama langganan utama mereka. Add-on sangat cocok untuk penagihan berbasis seat, peningkatan fitur, perluasan penggunaan, dan layanan tambahan.

Add-on yang dilampirkan ke produk langganan di dashboard

Manfaat Utama

Add-on memungkinkan model harga yang fleksibel, optimalisasi pendapatan melalui peluang upsell, pengelolaan yang lebih sederhana dari satu dashboard, serta pilihan bagi pelanggan untuk menyesuaikan langganan mereka.

Membuat Add-on

Add-on dibuat sebagai produk terpisah di dashboard, lalu dilampirkan ke produk langganan. Dengan demikian, Anda dapat menggunakan kembali add-on di beberapa langganan dan mengelola harga secara independen.

Konfigurasi Add-on

Saat membuat add-on, Anda dapat mengonfigurasi:

Harga: Tetapkan jumlah add-on (price) dalam unit mata uang terkecil. Add-on ditagihkan mengikuti siklus langganan induk
Mata uang: Tetapkan harga dasar dalam mata uang apa pun yang dapat digunakan Dodo Payments untuk menagih. Pemilih mata uang yang dapat dicari menempatkan USD, GBP, EUR, dan INR di bagian atas; pelanggan di luar mata uang dasar Anda akan ditagih melalui Adaptive Currency
Kuantitas: Pelanggan memilih kuantitas saat add-on dilampirkan ke langganan
Ketersediaan: Lampirkan add-on ke produk langganan melalui daftar addons pada setiap produk. Add-on itu sendiri tidak memiliki pengaturan ketersediaan
Pengaturan pajak: Konfigurasikan tax_category yang sesuai

Memulai

Siap menerapkan add-on dalam bisnis langganan Anda? Berikut cara untuk memulainya:

Plan Your Add-ons

Identifikasi fitur, layanan, atau kapasitas tambahan yang akan bermanfaat bagi pelanggan Anda sebagai add-on.Pertimbangkan:

Apa yang sering diminta pelanggan?
Fitur apa yang dapat dimonetisasi secara terpisah?
Hal apa yang dapat menciptakan jalur peningkatan yang alami?

Create Your First Add-on

Gunakan dashboard atau API Dodo Payments untuk membuat produk add-on pertama Anda.

Dashboard Guide

Ikuti panduan langkah demi langkah kami untuk membuat add-on di dashboard.

Attach to Subscriptions

Hubungkan add-on Anda ke produk langganan yang sesuai agar add-on tersebut tersedia.

Test Integration

Buat sesi checkout pengujian dengan berbagai kombinasi add-on untuk memastikan semuanya berfungsi dengan benar.

Monitor Performance

Lacak tingkat adopsi add-on dan dampaknya terhadap pendapatan untuk mengoptimalkan strategi harga Anda.

Kasus Penggunaan Umum

Penagihan berbasis seat: Anggota tim tambahan, lisensi pengguna, atau pengguna bersamaan
Peningkatan fitur: Fitur premium, analitik lanjutan, atau dukungan prioritas
Perluasan penggunaan: Penyimpanan tambahan, panggilan API, atau alokasi bandwidth
Layanan tambahan: Layanan profesional, pelatihan, atau jam konsultasi

Contoh Integrasi

Sesi Checkout dengan Add-on

Saat membuat sesi checkout, sertakan add-on dengan kuantitas:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1,
      addons: [
        {
          addon_id: 'addon_456',
          quantity: 3 // 3 additional seats
        }
      ]
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123",
            "quantity": 1,
            "addons": [
                {
                    "addon_id": "addon_456",
                    "quantity": 3  # 3 additional seats
                }
            ]
        }
    ],
    customer={"email": "customer@example.com"},
    return_url="https://yourapp.com/success"
)

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123",
        "quantity": 1,
        "addons": [
          {
            "addon_id": "addon_456",
            "quantity": 3
          }
        ]
      }
    ],
    "customer": {"email": "customer@example.com"},
    "return_url": "https://yourapp.com/success"
  }'

Agar pelanggan dapat menambahkan atau menghapus add-on sendiri di halaman checkout, tetapkan feature flag allow_editing_addons ke true saat membuat sesi. Nilai default-nya adalah false dan hanya berlaku untuk produk langganan.

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  feature_flags: {
    allow_editing_addons: true // customers can edit add-ons at checkout
  },
});

Perubahan Paket dengan Add-on

Modifikasi langganan yang ada untuk menambahkan, menghapus, atau memperbarui add-on:

// Add add-ons to existing subscription
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [
    { addon_id: 'addon_123', quantity: 2 }
  ]
});

// Remove all existing add-ons
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [] // Empty array removes all existing add-ons
});

# Add add-ons to existing subscription
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[
        {'addon_id': 'addon_123', 'quantity': 2}
    ]
)

# Remove all existing add-ons
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[]
)

Harga Dinamis

Hitung total biaya secara dinamis berdasarkan pilihan add-on:

interface AddonSelection {
  price: number;
  quantity: number;
}

function calculateTotalCost(basePrice: number, addons: AddonSelection[]) {
  const addonTotal = addons.reduce((sum, addon) => 
    sum + (addon.price * addon.quantity), 0
  );
  return basePrice + addonTotal;
}

Pengelolaan API

Dodo Payments menyediakan API komprehensif untuk mengelola add-on secara terprogram:

Create Add-ons

Gunakan endpoint POST /addons untuk membuat add-on baru dengan harga, deskripsi, dan opsi konfigurasi khusus.

API Reference

Lihat dokumentasi API lengkap untuk membuat add-on.

Update Add-ons

Modifikasi add-on yang ada menggunakan endpoint PATCH /addons/{id} untuk memperbarui harga, deskripsi, atau kategori pajak.

API Reference

Pelajari cara memperbarui detail add-on secara terprogram.

List and Retrieve

Gunakan GET /addons untuk mencantumkan semua add-on atau GET /addons/{id} untuk mengambil detail add-on tertentu.

API Reference

Akses dokumentasi API lengkap untuk pencantuman dan pengambilan data.

Image Management

Perbarui gambar add-on menggunakan endpoint PUT /addons/{id}/images untuk menampilkan produk dengan lebih baik.

API Reference

Pelajari cara mengelola gambar add-on melalui API.

Praktik Terbaik

Mulai dengan sederhana: Luncurkan 2–3 add-on inti dan perluas opsi berdasarkan masukan serta penggunaan pelanggan.
Jaga kejelasan harga: Komunikasikan harga dan nilai add-on dengan jelas agar pelanggan memahami apa yang mereka dapatkan dengan biaya tambahan tersebut.
Uji secara menyeluruh: Validasi kombinasi add-on untuk memastikan perhitungan harga tetap akurat dan alur checkout berjalan lancar.

Pertimbangan Desain

Proposisi Nilai yang Jelas: Setiap add-on harus memiliki manfaat jelas yang dapat dipahami pelanggan
Pengelompokan Logis: Kelompokkan add-on terkait dalam alur checkout Anda
Kuantitas Fleksibel: Izinkan pelanggan menyesuaikan kuantitas add-on sesuai kebutuhan
Harga Transparan: Tampilkan total biaya dengan jelas di seluruh proses checkout

Terkait

Seat-Based Billing

Panduan untuk menerapkan harga per seat dengan add-on.

Checkout Sessions

API dan konfigurasi sesi checkout lengkap.

Subscriptions

Siklus hidup langganan, siklus penagihan, dan perpanjangan.

Adaptive Currency

Tampilkan harga dalam mata uang lokal saat checkout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Seat-Based Billing

Usage Extensions

Apa Itu Add-on?

Manfaat Utama

Membuat Add-on

Konfigurasi Add-on

Memulai

Dashboard Guide

Kasus Penggunaan Umum

Contoh Integrasi

Sesi Checkout dengan Add-on

Perubahan Paket dengan Add-on

Harga Dinamis

Pengelolaan API

API Reference

API Reference

API Reference

API Reference

Praktik Terbaik

Pertimbangan Desain

Terkait

Seat-Based Billing

Checkout Sessions

Subscriptions

Adaptive Currency

Seat-Based Billing

Usage Extensions

​Apa Itu Add-on?

​Manfaat Utama

​Membuat Add-on

​Konfigurasi Add-on

​Memulai

Dashboard Guide

​Kasus Penggunaan Umum

​Contoh Integrasi

​Sesi Checkout dengan Add-on

​Perubahan Paket dengan Add-on

​Harga Dinamis

​Pengelolaan API

API Reference

API Reference

API Reference

API Reference

​Praktik Terbaik

​Pertimbangan Desain

​Terkait

Seat-Based Billing

Checkout Sessions

Subscriptions

Adaptive Currency

Apa Itu Add-on?

Manfaat Utama

Membuat Add-on

Konfigurasi Add-on

Memulai

Kasus Penggunaan Umum

Contoh Integrasi

Sesi Checkout dengan Add-on

Perubahan Paket dengan Add-on

Harga Dinamis

Pengelolaan API

Praktik Terbaik

Pertimbangan Desain

Terkait