> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# v1.99.0 (25 Mei 2026)
> Kode diskon bertumpuk (hingga 20 per checkout, pembayaran, atau langganan), tujuh email notifikasi pelanggan baru untuk refund dan event siklus langganan, perombakan halaman pembayaran checkout yang meningkatkan tingkat keberhasilan sebesar 2–3%, pengerjaan ulang formulir produk dengan pratinjau langsung dan autosave, serta desain ulang Business Settings
## Fitur Baru
### 1. **Kode Diskon Bertumpuk**
Sesi checkout, pembayaran, langganan, dan perubahan paket sekarang menerima **hingga 20 kode diskon dalam satu permintaan** melalui array `discount_codes`. Kode diterapkan **sesuai urutan array** — kode yang memenuhi syarat pertama kali mengurangi harga dasar, yang kedua mengurangi harga yang sudah di-diskon, dan seterusnya — sehingga Anda dapat melapisi kampanye tanpa membuat kode gabungan khusus.
```typescript theme={null}
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
customer: { email: 'user@example.com' },
return_url: 'https://yoursite.com/return'
});
```
**Di mana itu berlaku**
| Permukaan | Kolom | Maksimal kode |
| --------------- | ---------------- | ------------- |
| Sesi Checkout | `discount_codes` | 20 |
| Pembayaran | `discount_codes` | 20 |
| Langganan | `discount_codes` | 20 |
| Perubahan Paket | `discount_codes` | 20 |
**Perilaku perubahan paket**
| Nilai `discount_codes` | Efek |
| --------------------------- | --------------------------------------------------------------------------------------------- |
| Tidak disediakan | Diskon yang ada dengan `preserve_on_plan_change=true` tetap ada jika berlaku pada produk baru |
| `[]` (array kosong) | Semua diskon yang ada dihapus dari langganan |
| `['CODE_A', 'CODE_B', ...]` | Menggantikan diskon yang ada dengan set bertumpuk ini, diterapkan sesuai urutan array |
**Bentuk respons**
Set lengkap diskon yang diterapkan dikembalikan di bawah array `discounts` pada pembayaran dan langganan — setiap entri termasuk `discount_id`, `position`, dan `cycles_remaining` (untuk langganan). Kolom tunggal `discount_id` yang lama telah dihentikan tetapi masih ada untuk kompatibilitas mundur.
Kolom tunggal `discount_code` **dihentikan** tetapi masih sepenuhnya didukung — integrasi yang ada terus berfungsi tanpa perubahan. Tidak dapat digabungkan dengan `discount_codes` dalam permintaan yang sama. Kami menyarankan untuk bermigrasi ke `discount_codes` saat nyaman, bahkan untuk satu kode, untuk memanfaatkan penumpukan dan bentuk respons yang lebih kaya.
Pelajari lebih lanjut: [Kode Diskon](/features/discount-codes) | [Sesi Checkout](/developer-resources/checkout-session) | [Perubahan Paket](/developer-resources/subscription-upgrade-downgrade)
### 2. **Tujuh Email Notifikasi Pelanggan Baru**
Tujuh email transaksi baru sekarang dikirimkan kepada pelanggan Anda secara otomatis, mencakup konfirmasi pengembalian dana, tonggak siklus hidup langganan, dan kegagalan pembayaran. Setiap email dapat diaktifkan secara independen dari **Pengaturan → Komunikasi** di bawah bagian **Email Pelanggan**.
**Opt-in (diaktifkan secara default)**
| Email | Kapan dipicu |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Pengembalian Dana Berhasil** | Sebuah pengembalian dana berhasil diproses dan dana dalam perjalanan kembali ke pelanggan |
| **Uji coba Berakhirnya Langganan** | \~2 hari sebelum percobaan berakhir dan biaya penagihan pertama terjadi |
| **Langganan Dibatalkan Segera** | Sebuah langganan dibatalkan dengan efek langsung |
| **Langganan Ditetapkan untuk Dibatalkan pada Tanggal Penagihan Berikutnya** | Sebuah langganan dijadwalkan untuk dibatalkan di akhir periode penagihan saat ini |
**Opt-out (dinonaktifkan secara default)**
| Email | Kapan dipicu |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pembayaran Gagal** | Sebuah percobaan pembayaran gagal — aktifkan jika Anda menginginkan Dodo Payments memberitahu pelanggan secara langsung daripada menangani di sistem Anda sendiri |
| **Pembaharuan Langganan Gagal** | Pembayaran pembaharuan langganan gagal secara spesifik; dipicu menggantikan (bukan selain) email Pembayaran Gagal umum untuk pembayaran pembaharuan |
| **Pengingat Pembaharuan Mendatang** | \~2 hari sebelum langganan diperbarui |
Jika Anda mengelola komunikasi pelanggan sendiri melalui webhooks, biarkan email opt-out dinonaktifkan untuk menghindari pengiriman notifikasi duplikat kepada pelanggan untuk acara yang sama.
Email pelanggan terpisah dari email notifikasi yang dikirim ke tim Anda. Menonaktifkan email pelanggan tidak mempengaruhi notifikasi tim Anda untuk acara yang sama.
Pelajari lebih lanjut: [Preferensi Komunikasi](/features/communication-preferences)
## Peningkatan
### 3. **Perombakan Halaman Pembayaran Checkout**
Halaman pembayaran pada checkout telah dikerjakan ulang secara menyeluruh dari awal hingga akhir — tata letak yang lebih ringkas, waktu muat yang dirasakan lebih cepat, status validasi yang lebih jelas, serta UX input kartu yang disempurnakan. Secara keseluruhan, perubahan ini meningkatkan **tingkat keberhasilan checkout yang teramati sekitar 2–3%** di seluruh traffic global.
Yang berubah:
* **Interaksi field yang lebih lancar** — autofocus, urutan tab yang lebih cerdas, dan navigasi keyboard yang lebih baik pada formulir kartu
* **Status error dan loading yang lebih rapi** — validasi inline ditampilkan tepat di tempat pelanggan perlu melakukan tindakan, menggantikan pola banner error seluruh formulir sebelumnya
* **Render yang lebih cepat** — skeleton dan progressive hydration menghilangkan flicker singkat pada kondisi kosong di jaringan lambat
* **Penyempurnaan mobile** — target ketuk, perilaku scroll, dan penanganan keyboard disesuaikan secara khusus untuk checkout mobile, tempat sebagian besar traffic kini berasal
Tidak diperlukan perubahan integrasi. Checkout sessions yang ada akan otomatis menggunakan halaman pembayaran baru.
### 4. **Pengerjaan Ulang Formulir Produk**
Alur **create**, **edit**, dan **duplicate** produk telah dibangun ulang dari awal dengan berpusat pada satu pengalaman formulir yang konsisten.
Sorotan:
* **Pratinjau langsung** — lihat tampilan produk Anda pada checkout dan Customer Portal saat mengedit, berdampingan dengan formulir
* **Autosave** — draft disimpan secara otomatis, sehingga berpindah halaman atau kehilangan tab tidak lagi berarti kehilangan pekerjaan Anda
* **Editor Markdown** — deskripsi produk kini mendukung editor markdown lengkap dengan rendering langsung, pratinjau tautan, dan kontrol pemformatan inline
* **Kesetaraan alur duplicate** — menduplikasi produk akan membuka formulir terpadu yang sama dalam keadaan telah terisi, bukan dialog sederhana, sehingga Anda dapat menyesuaikan setiap field sebelum menyimpan salinan
Gunakan **Duplicate** untuk membuat varian regional atau berdasarkan tingkat harga dari produk yang sudah ada tanpa memasukkan ulang deskripsi, metadata, atau konfigurasi pemenuhan.
### 5. **Desain Ulang Halaman Business Settings**
Halaman **Settings → Business** telah didesain ulang agar konfigurasi lebih mudah dipindai dan lebih cepat diperbarui. Settings kini dikelompokkan ke dalam bagian yang lebih jelas, dengan teks penjelasan yang menerangkan dampak setiap toggle sebelum Anda mengaktifkannya.
Tidak ada **perubahan perilaku** pada settings yang ada — hanya tata letak, pengelompokan, dan penjelasan di sekitarnya yang telah ditingkatkan.
## Peningkatan
* **`credits_amount` override kini diteruskan dengan benar ke rute GET checkout session dan payment link** — ketika checkout session atau payment link dibuat dengan override `credit_entitlements` per-checkout, pengambilan session atau link tersebut melalui GET mengembalikan `credits_amount` default tingkat produk, bukan nilai yang dioverride. Masalah ini kini telah diperbaiki.
* **Tindakan refund dinonaktifkan untuk pembayaran yang telah sepenuhnya direfund** — tombol Refund pada pembayaran kini dinonaktifkan setelah pembayaran sepenuhnya direfund, dengan tooltip yang menjelaskan alasannya. Sebelumnya, tombol tersebut tetap aktif dan baru menampilkan error setelah dikirimkan.
* Perbaikan bug minor dan peningkatan stabilitas di seluruh platform
