Fitur Checkout

Checkout yang dioptimalkan untuk konversi, mematuhi standar global dengan dukungan multi-mata uang, multi-bahasa, perhitungan pajak otomatis, kode diskon, add-on, dan pengumpulan alamat yang cerdas.

Checkout Dodo Payments adalah halaman pembayaran hosted yang dirancang untuk produk digital dan SaaS. Checkout ini menangani konversi mata uang, penghitungan pajak, kode diskon, pengumpulan alamat, dan pemilihan metode pembayaran. Anda membuat sesi checkout melalui API atau dashboard, lalu pelanggan menyelesaikan pembayaran di halaman yang aman dan menggunakan branding Anda.

Checkout Sessions API

Buat sesi checkout secara terprogram.

Preview Checkout

Hitung harga dan pajak sebelum membuat sesi.

Payment Methods

Metode pembayaran dan konfigurasi yang didukung.

Integration Guide

Panduan langkah demi langkah untuk mengintegrasikan checkout.

Link checkout yang dibuat melalui Checkout Sessions API tidak dapat digunakan kembali. Link tersebut kedaluwarsa setelah 24 jam, atau setelah 15 menit jika confirm: true ditetapkan. Buat sesi baru untuk setiap pelanggan dan setiap percobaan pembayaran.

​

Adaptive Currency

Adaptive Currency memungkinkan pelanggan membayar dalam mata uang lokal pilihan mereka, sehingga meningkatkan kepercayaan dan tingkat konversi.

Saat diaktifkan, pelanggan melihat pemilih mata uang di checkout. Harga dikonversi ke mata uang pilihan mereka menggunakan kurs FX terkini. Jika produk mengaktifkan Purchasing Power Parity, harga yang disesuaikan dengan PPP akan dikonversi, bukan harga dasar. Jika Charm Pricing diaktifkan, jumlah hasil konversi akan dibulatkan ke akhiran yang rapi seperti 49.99.

Untuk mengaktifkan Adaptive Currency, buka Settings → Business lalu aktifkan toggle-nya.

Adaptive Currency

Mata uang yang didukung, biaya konversi, dan penanganan pengembalian dana.

​

Checkout Multi-Bahasa

Checkout mendukung 22 bahasa. Pelanggan dapat mengganti bahasa langsung di halaman, dan teks UI, label, serta pesan sistem dilokalkan.

Dalam bahasa Arab dan Ibrani, checkout dirender dari kanan ke kiri dan seluruh tata letak dicerminkan. Alamat email, kode, dan nomor telepon tetap mempertahankan urutan baca alaminya.

​

Bahasa yang Didukung

Bahasa	Kode
Arab	ar
Katalan	ca
Mandarin	zh
Belanda	nl
Inggris	en
Prancis	fr
Georgia	ka
Jerman	de
Ibrani	he
Indonesia	id
Italia	it
Jepang	ja
Korea	ko
Melayu	ms
Polandia	pl
Portugis	pt
Rumania	ro
Rusia	ru
Spanyol	es
Swedia	sv
Thai	th
Turki	tr

Untuk memaksa penggunaan bahasa tertentu, tetapkan customization.force_language saat membuat sesi checkout. Lihat Checkout Sessions API untuk detailnya.

​

Penghitungan Pajak Otomatis

Pajak dihitung secara otomatis berdasarkan lokasi penagihan pelanggan, sehingga memastikan kepatuhan terhadap persyaratan GST, VAT, dan pajak penjualan.

Aturan pajak diterapkan berdasarkan negara dan wilayah pelanggan jika berlaku. Jumlah pajak diperbarui secara otomatis saat pelanggan mengubah negaranya atau memperbarui alamatnya. Perincian pajak akhir ditampilkan dengan jelas sebelum pembayaran.

Penghitungan pajak sepenuhnya otomatis. Tidak diperlukan konfigurasi manual untuk produk digital dan produk SaaS standar.

​

Dukungan Business Tax ID

Untuk transaksi B2B, checkout memungkinkan pelanggan memasukkan Business Tax ID mereka (misalnya nomor VAT atau GST). Setelah dimasukkan, tax ID divalidasi secara real-time dan pengecualian pajak atau aturan reverse charge yang berlaku diterapkan secara otomatis.

​

Kode Diskon

Pelanggan dapat menerapkan kode diskon atau promo yang Anda buat di dashboard. Diskon divalidasi secara instan dan harga yang diperbarui ditampilkan.

Saat Purchasing Power Parity diaktifkan pada suatu produk, diskon diterapkan pada harga yang disesuaikan dengan PPP, bukan harga dasar.

Anda dapat menerapkan kode diskon terlebih dahulu atau mengaktifkan kolom input diskon melalui API:

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['WELCOME20'], // Pre-apply one or more codes (max 20)
  feature_flags: {
    allow_discount_code: true // Shown by default; set to false to hide the field
  },
  return_url: 'https://yoursite.com/return'
});

discount_codes menerima array yang berisi hingga 20 kode yang ditumpuk sesuai urutan. Kolom tunggal discount_code sudah deprecated, tetapi masih berfungsi untuk kompatibilitas mundur.

Discount Codes

Buat dan kelola kode diskon.

Validate Discount by Code

Cari dan validasi diskon menggunakan nama kode.

​

Pengumpulan Alamat Cerdas

Checkout mendukung pengisian alamat yang fleksibel untuk menyeimbangkan kecepatan, akurasi, dan cakupan global.

​

Opsi

Opsi	Deskripsi
Google Address Autofill	Pemilihan cepat dengan pelengkapan otomatis
Entri Manual	Kontrol penuh untuk alamat lengkap
Pemilihan Negara	Diperlukan untuk logika pajak dan kepatuhan
Mode Alamat Minimal	Hanya mengumpulkan negara dan ZIP jika diperlukan untuk pajak

​

Mode Alamat Minimal

Untuk memaksimalkan konversi, aktifkan pengumpulan alamat minimal guna mengurangi hambatan dalam checkout. Saat minimal_address ditetapkan ke true, checkout hanya mengumpulkan:

• Negara — selalu diperlukan untuk menentukan pajak
• Kode ZIP/Pos — hanya di wilayah yang memerlukannya untuk penghitungan pajak penjualan, VAT, atau GST

Semua kolom alamat lainnya dilewati.

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  minimal_address: true,
  return_url: 'https://yoursite.com/return'
});

Pengumpulan alamat lengkap adalah default. Aktifkan minimal_address untuk produk digital dan alur SaaS yang tidak memerlukan detail penagihan lengkap.

​

Pengumpulan Nomor Telepon

Kontrol apakah kolom nomor telepon ditampilkan di checkout dan apakah kolom tersebut wajib diisi.

Flag	Default	Perilaku
allow_phone_number_collection	true	Menampilkan kolom nomor telepon
require_phone_number	false	Menjadikan kolom nomor telepon wajib diisi

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_phone_number_collection: true,
    require_phone_number: true
  },
  return_url: 'https://yoursite.com/return'
});

require_phone_number: true memerlukan allow_phone_number_collection: true. API menolak sesi ketika pengumpulan nomor telepon dinonaktifkan sementara nomor telepon diwajibkan.

​

Kolom Kustom

Kumpulkan informasi tambahan dari pelanggan selama checkout dengan menentukan kolom formulir kustom. Ini berguna untuk mengumpulkan nama perusahaan, ukuran tim, sumber rujukan, atau data spesifik bisnis lainnya.

​

Jenis Kolom yang Tersedia

Jenis	Deskripsi
text	Input teks satu baris
number	Input numerik
email	Alamat email dengan validasi
url	URL dengan validasi
date	Pemilih tanggal
dropdown	Memilih dari opsi yang telah ditentukan
boolean	Toggle Ya/Tidak

​

Contoh

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      required: true,
      options: ['1-10', '11-50', '51-200', '200+']
    }
  ],
  return_url: 'https://yoursite.com/return'
});

Respons pelanggan secara otomatis disertakan dalam payload webhook (payment.succeeded, subscription.active) dan respons API melalui array custom_field_responses. Anda dapat menentukan hingga 5 kolom kustom per sesi checkout.

Custom Fields Guide

Konfigurasi kolom kustom dan akses respons.

​

Penerimaan Privacy Policy & Terms

Untuk memastikan transparansi hukum dan kepatuhan:

• Tautan Privacy Policy dan Buyer Terms ditampilkan dengan jelas di checkout
• Pelanggan secara eksplisit menyetujui keduanya sebelum menyelesaikan pembayaran

Hal ini membantu memenuhi persyaratan perlindungan konsumen dan privasi data global, termasuk kepatuhan GDPR.

​

Koleksi Produk

Koleksi Produk memungkinkan pengalaman checkout terpadu, tempat pelanggan dapat melihat dan memilih beberapa produk terkait (misalnya paket Starter, Pro, dan Enterprise) dalam satu checkout.

Saat menggunakan koleksi, semua produk aktif dalam koleksi akan ditampilkan. Produk pertama dipilih sebelumnya, dan pelanggan dapat membandingkan opsi sebelum menentukan pilihan.

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

Saat menggunakan product_collection_id, berikan array product_cart kosong. Kode diskon tidak dapat diterapkan sebelumnya saat pembuatan sesi.

Product Collections

Buat dan kelola koleksi produk.

​

Konfigurasi Checkout Session

Kontrol perilaku checkout menggunakan Checkout Sessions API:

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  customer: {
    email: '[e-mail]',
    name: 'Jane Doe'
  },
  billing_currency: 'EUR',
  discount_codes: ['PROMO10'],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return',
  cancel_url: 'https://yoursite.com/pricing',
  metadata: {
    order_ref: 'ORD-12345'
  }
});

Setelah pembayaran, pelanggan dialihkan ke return_url Anda dengan parameter kueri yang ditambahkan secara otomatis — termasuk payment_id atau subscription_id, status, email, dan license_key (jika berlaku). Lihat panduan Checkout Sessions untuk daftar lengkapnya.

Checkout Sessions API

Referensi API lengkap untuk checkout sessions.

Checkout Integration Guide

Panduan langkah demi langkah untuk mengintegrasikan checkout.

​

Kustomisasi Tema

Sesuaikan tampilan halaman checkout agar sesuai dengan merek Anda menggunakan parameter customization.theme_config. Konfigurasikan warna, font, radius border, dan teks tombol untuk mode terang maupun gelap.

Bagian ini membahas API sisi server, yang menggunakan nama properti seperti bg_primary. Tema yang ditetapkan pada sesi berlaku untuk checkout hosted, overlay, dan inline. Opsi sisi klien themeConfig milik Checkout SDK, yang menggunakan nama properti seperti bgPrimary, sudah deprecated. Lihat Overlay Checkout.

Design & Theme Customization

Konfigurasikan tema secara visual dari dashboard dengan tema siap pakai, tipografi, warna, dan pratinjau langsung.

​

Opsi Konfigurasi Tema

Properti	Deskripsi
light	Konfigurasi warna untuk mode terang
dark	Konfigurasi warna untuk mode gelap
font_primary_url	URL untuk font utama
font_secondary_url	URL untuk font sekunder
font_size	Ukuran font: xs, sm, md, lg, xl, 2xl
font_weight	Ketebalan font: normal, medium, bold, extraBold
radius	Radius border untuk elemen UI (misalnya 4px, 0.5rem, 8px)
pay_button_text	Teks kustom untuk tombol pembayaran (misalnya, “Complete Purchase”, “Subscribe Now”)

​

Konfigurasi Warna (Mode Terang/Gelap)

Setiap mode mendukung properti warna berikut:

Properti	Deskripsi
bg_primary	Warna latar utama
bg_secondary	Warna latar sekunder
text_primary	Warna teks utama
text_secondary	Warna teks sekunder
text_placeholder	Warna placeholder teks
text_error	Warna teks error
text_success	Warna teks sukses
border_primary	Warna border utama
border_secondary	Warna border sekunder
button_primary	Warna latar tombol utama
button_primary_hover	Warna hover tombol utama
button_secondary	Warna latar tombol sekunder
button_secondary_hover	Warna hover tombol sekunder
button_text_primary	Warna teks tombol utama
button_text_secondary	Warna teks tombol sekunder
input_focus_border	Warna border fokus input

Semua kolom warna menerima format warna CSS standar:

• Hex: #fff, #ffffff, #ffffffff
• RGB/RGBA: rgb(255, 255, 255), rgba(255, 255, 255, 0.5)
• HSL/HSLA: hsl(120, 100%, 50%), hsla(120, 100%, 50%, 0.5)
• Warna bernama: red, blue, transparent

​

Contoh

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  customization: {
    theme_config: {
      font_primary_url: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap',
      font_size: 'md',
      font_weight: 'medium',
      radius: '8px',
      pay_button_text: 'Complete Purchase',
      light: {
        bg_primary: '#ffffff',
        bg_secondary: '#f5f5f5',
        text_primary: '#1a1a1a',
        text_secondary: '#666666',
        button_primary: '#0066ff',
        button_primary_hover: '#0052cc',
        button_text_primary: '#ffffff',
        border_primary: '#e0e0e0'
      },
      dark: {
        bg_primary: '#1a1a1a',
        bg_secondary: '#2d2d2d',
        text_primary: '#ffffff',
        text_secondary: '#a0a0a0',
        button_primary: '#3385ff',
        button_primary_hover: '#4d99ff',
        button_text_primary: '#ffffff',
        border_primary: '#404040'
      }
    }
  },
  return_url: 'https://yoursite.com/return'
});

Anda tidak perlu menentukan semua properti warna. Properti yang tidak ditentukan menggunakan nilai tema default.