
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.
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.
Bahasa yang Didukung
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 mengganti negara atau memperbarui alamat. Perincian pajak akhir ditampilkan dengan jelas sebelum pembayaran.Dukungan ID Pajak Bisnis
Untuk transaksi B2B, checkout memungkinkan pelanggan memasukkan ID Pajak Bisnis mereka (misalnya nomor VAT atau GST). Setelah dimasukkan, ID pajak 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 langsung dan harga yang diperbarui ditampilkan. Saat Purchasing Power Parity diaktifkan pada produk, diskon diterapkan pada harga yang disesuaikan dengan PPP, bukan harga dasar.
discount_codes menerima array 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
Mode Alamat Minimal
Untuk memaksimalkan konversi, aktifkan pengumpulan alamat minimal guna mengurangi hambatan checkout. Saatminimal_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

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.Kolom Kustom
Kumpulkan informasi tambahan dari pelanggan selama checkout dengan menentukan kolom formulir kustom. Fitur ini berguna untuk mengumpulkan nama perusahaan, ukuran tim, sumber rujukan, atau data spesifik bisnis lainnya.Jenis Kolom yang Tersedia
Contoh
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 untuk setiap sesi checkout.Custom Fields Guide
Konfigurasi kolom kustom dan cara mengakses respons.
Penerimaan Kebijakan Privasi & Ketentuan
Untuk memastikan transparansi hukum dan kepatuhan:- Link Privacy Policy dan Buyer Terms ditampilkan dengan jelas di checkout
- Pelanggan secara eksplisit menyetujui hal tersebut 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 melihat dan memilih beberapa produk terkait (misalnya paket Starter, Pro, dan Enterprise) dalam satu checkout. Saat menggunakan koleksi, semua produk aktif dalam koleksi ditampilkan. Produk pertama dipilih sebelumnya, dan pelanggan dapat membandingkan opsi sebelum memilih.Product Collections
Buat dan kelola koleksi produk.
Konfigurasi Sesi Checkout
Kontrol perilaku checkout menggunakan Checkout Sessions API:Setelah pembayaran, pelanggan dialihkan ke
return_url Anda dengan query parameter 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 sesi checkout.
Checkout Integration Guide
Panduan langkah demi langkah untuk mengintegrasikan checkout.
Kustomisasi Tema
Sesuaikan tampilan halaman checkout agar sesuai dengan branding Anda menggunakan parametercustomization.theme_config. Konfigurasikan warna, font, radius border, dan teks tombol untuk mode terang dan 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 themeConfig sisi klien Checkout SDK, yang menggunakan nama properti seperti bgPrimary, sudah deprecated. Lihat Overlay Checkout.

Design & Theme Customization
Konfigurasikan tema secara visual dari dashboard menggunakan tema siap pakai, tipografi, warna, dan pratinjau langsung.
Opsi Konfigurasi Tema
Konfigurasi Warna (Mode Terang/Gelap)
Setiap mode mendukung properti warna berikut: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