Prasyarat
Untuk mengintegrasikan API Pembayaran Dodo, Anda memerlukan:- Akun pedagang Pembayaran Dodo
- Kredensial API (kunci API dan kunci rahasia webhook) dari dasbor
Pengaturan Dasbor
- Arahkan ke Dasbor Pembayaran Dodo
- Buat produk (pembayaran sekali atau langganan)
-
Hasilkan kunci API Anda:
- Pergi ke Developer > API
- Panduan Detail
- Salin kunci API di env bernama DODO_PAYMENTS_API_KEY
-
Konfigurasi webhook:
- Pergi ke Developer > Webhooks
- Buat URL webhook untuk notifikasi pembayaran
- Salin kunci rahasia webhook di env
Integrasi
Tautan Pembayaran
Pilih jalur integrasi yang sesuai dengan kasus penggunaan Anda:- Sesi Checkout (direkomendasikan): Terbaik untuk sebagian besar integrasi. Buat sesi di server Anda dan arahkan pelanggan ke checkout yang aman dan dihosting.
- Checkout Overlay (tertanam): Gunakan saat Anda memerlukan pengalaman dalam halaman yang menyematkan checkout yang dihosting di situs Anda.
- Tautan Pembayaran Statis: URL yang dapat dibagikan tanpa kode untuk pengumpulan pembayaran cepat.
- Tautan Pembayaran Dinamis: Tautan yang dibuat secara programatik. Namun, Sesi Checkout direkomendasikan dan memberikan lebih banyak fleksibilitas.
1. Sesi Checkout
Gunakan Sesi Checkout untuk membuat pengalaman checkout yang aman dan dihosting untuk pembayaran sekali atau langganan. Anda membuat sesi di server Anda, lalu mengarahkan pelanggan kecheckout_url yang dikembalikan.
Sesi checkout berlaku selama 24 jam secara default. Jika Anda mengirim
confirm=true, sesi berlaku selama 15 menit dan semua bidang yang diperlukan harus disediakan.1
Buat sesi checkout
Pilih SDK pilihan Anda atau panggil REST API.
- Node.js SDK
- Python SDK
- REST API
2
Arahkan pelanggan ke checkout
Setelah sesi dibuat, arahkan ke
checkout_url untuk memulai alur yang dihosting.2. Checkout Overlay
Untuk pengalaman checkout dalam halaman yang mulus, jelajahi integrasi Checkout Overlay kami yang memungkinkan pelanggan menyelesaikan pembayaran tanpa meninggalkan situs web Anda.3. Tautan Pembayaran Statis
Tautan pembayaran statis memungkinkan Anda dengan cepat menerima pembayaran dengan membagikan URL sederhana. Anda dapat menyesuaikan pengalaman checkout dengan mengirimkan parameter kueri untuk mengisi detail pelanggan, mengontrol bidang formulir, dan menambahkan metadata kustom.1
Buat tautan pembayaran Anda
Mulailah dengan URL dasar dan tambahkan ID produk Anda:
2
Tambahkan parameter inti
Sertakan parameter kueri penting:
-
Jumlah item yang akan dibeli.
-
URL untuk mengarahkan setelah penyelesaian pembayaran.
URL pengalihan akan menyertakan detail pembayaran sebagai parameter kueri, misalnya:
https://example.com/?payment_id=pay_ts2ySpzg07phGeBZqePbH&status=succeeded3
Isi informasi pelanggan (opsional)
Tambahkan bidang pelanggan atau penagihan sebagai parameter kueri untuk memperlancar checkout.
Bidang Pelanggan yang Didukung
Bidang Pelanggan yang Didukung
-
Nama lengkap pelanggan (diabaikan jika firstName atau lastName disediakan).
-
Nama depan pelanggan.
-
Nama belakang pelanggan.
-
Alamat email pelanggan.
-
Negara pelanggan.
-
Alamat jalan.
-
Kota.
-
Negara bagian atau provinsi.
-
Kode pos/ZIP.
-
true atau false
4
Kontrol bidang formulir (opsional)
Anda dapat menonaktifkan bidang tertentu agar hanya dapat dibaca oleh pelanggan. Ini berguna ketika Anda sudah memiliki detail pelanggan (misalnya, pengguna yang sudah masuk).
disable… yang sesuai ke true:- Tabel Bendera Nonaktif
| Bidang | Bendera Nonaktif | Parameter Diperlukan |
|---|---|---|
| Nama Lengkap | disableFullName | fullName |
| Nama Depan | disableFirstName | firstName |
| Nama Belakang | disableLastName | lastName |
disableEmail | email | |
| Negara | disableCountry | country |
| Alamat Jalan | disableAddressLine | addressLine |
| Kota | disableCity | city |
| Negara Bagian | disableState | state |
| Kode ZIP | disableZipCode | zipCode |
Mengatur
showDiscounts=false akan menonaktifkan dan menyembunyikan bagian diskon di formulir checkout. Gunakan ini jika Anda ingin mencegah pelanggan memasukkan kupon atau kode promo selama checkout.5
Tambahkan kontrol lanjutan (opsional)
-
Menentukan mata uang pembayaran. Secara default menggunakan mata uang negara penagihan.
-
Tampilkan atau sembunyikan pemilih mata uang.
-
Jumlah dalam sen (hanya untuk harga Bayar Sesuai Keinginan).
-
Bidang metadata kustom (misalnya,
metadata_orderId=123).
6
Bagikan tautan
Kirim tautan pembayaran yang telah selesai kepada pelanggan Anda. Ketika mereka mengunjungi, semua parameter kueri dikumpulkan dan disimpan dengan ID sesi. URL kemudian disederhanakan untuk hanya menyertakan parameter sesi (misalnya,
?session=sess_1a2b3c4d). Informasi yang disimpan bertahan melalui penyegaran halaman dan dapat diakses sepanjang proses checkout.Pengalaman checkout pelanggan sekarang lebih lancar dan dipersonalisasi berdasarkan parameter Anda.
4. Tautan Pembayaran Dinamis
Dibuat melalui panggilan API atau SDK kami dengan detail pelanggan. Berikut adalah contohnya: Ada dua API untuk membuat tautan pembayaran dinamis:- API Tautan Pembayaran Sekali Referensi API
- API Tautan Pembayaran Langganan Referensi API
Pastikan Anda mengirim
payment_link = true untuk mendapatkan tautan pembayaran - Node.js SDK
- Python SDK
- Go SDK
- Referensi API
Setelah membuat tautan pembayaran, arahkan pelanggan Anda untuk menyelesaikan pembayaran mereka.