Mengapa Metode Pembayaran India Penting
UPI Dominance
Low-Value Payments
Subscription Support
Metode yang Didukung
Tabel ini mencantumkan setiap metode, apakah mendukung subscription, dan jumlah minimumnya:Konfigurasi
Tipe API Method
Teruskan nilai-nilai ini diallowed_payment_method_types:
Contoh: Checkout Berfokus pada India
Sesi ini menawarkan UPI dan kartu kepada pelanggan di India, dengan penagihan dalam INR:Persyaratan untuk UPI
UPI hanya muncul saat checkout jika semua kondisi berikut terpenuhi:- billing country adalah India (
IN). - billing currency adalah INR.
- Untuk subscription dari merchant di luar India, Adaptive Currency diaktifkan. Checkout satu kali tidak memerlukannya jika produk diberi harga dalam INR.
Subscription dengan Mandate RBI
Subscription yang dibayar dengan UPI atau kartu yang diterbitkan di India berjalan menggunakan mandate RBI (Reserve Bank of India), yang menambahkan aturan yang tidak dimiliki metode pembayaran lainnya.Cara Kerja Mandate RBI
Pelanggan mengotorisasi mandate saat berlangganan. Setiap renewal charge kemudian menunggu 48 jam setelah notifikasi pre-debit sebelum bank mendebit dana:Tipe Mandate
Tipe mandate bergantung pada perbandingan jumlah subscription dengan batas minimum mandate:max(mandate_floor, billing_amount). Jika jumlah penagihan berada di bawah batas minimum, batas tersebut menjadi authorization ceiling yang ditampilkan kepada pelanggan.
Perubahan plan: Jika upgrade menghasilkan charge yang melebihi batas mandate yang ada, charge gagal dan pelanggan harus melakukan otorisasi lagi.
Batas Minimum Mandate yang Dapat Dikonfigurasi
Atur batas minimum mandate untuk e-mandate INR menggunakan fieldmandate_min_amount_inr_paise, dalam paise INR (₹1 = 100 paise).
Anda dapat mengganti default sistem sebesar ₹15.000 pada tiga tingkat:
mandate_min_amount_inr_paise dalam request body saat Anda membuat checkout session. Endpoint Create Subscription yang sudah deprecated menerima field yang sama.
Penundaan Pemrosesan Selama 48 Jam
Renewal charge pada kartu India atau UPI selesai sekitar 48 jam setelah tanggal renewal. Inilah perbedaan terpenting dibandingkan pembayaran dengan kartu internasional:Charge Initiated (Day 0)
Pre-Debit Notification
48-Hour Window
Debit Completed (~48-51 Hours)
Webhook Sent
payment.succeeded setelah debit aktual, bukan saat charge dimulai.Menangani Jendela 48 Jam
Berikan akses dari payment webhook, bukan dari tanggal renewal:Webhook Event untuk Subscription India
Tangani event berikut untuk subscription yang dibayar dengan UPI atau kartu yang diterbitkan di India:Pengujian
ID UPI untuk Pengujian
Dalam test mode, masukkan ID UPI berikut untuk menyimulasikan setiap hasil:Nomor Kartu India untuk Pengujian
Gunakan kartu pengujian yang diterbitkan di India berikut:Praktik Terbaik
Plan for the 48-hour delay
Plan for the 48-hour delay
- Masa tenggang untuk akses subscription
- Komunikasi yang jelas kepada pelanggan tentang waktu pemrosesan
- Fulfillment berbasis webhook, bukan fulfillment berbasis tanggal
Handle mandate cancellations
Handle mandate cancellations
subscription.on_hold, lalu minta pelanggan berlangganan kembali atau memperbarui payment method mereka.Set appropriate mandate amounts
Set appropriate mandate amounts
mandate_min_amount_inr_paise. Jika tidak, pelanggan harus mengotorisasi mandate baru.Offer UPI prominently
Offer UPI prominently
Pemecahan Masalah
UPI not appearing at checkout
UPI not appearing at checkout
- Apakah billing country diatur ke
IN? - Apakah billing currency diatur ke
INR? - Jika Anda adalah merchant di luar India, apakah Adaptive Currency diaktifkan?
- Apakah
upi_intenttercantum dalamallowed_payment_method_types?
country: "IN" di billing address dan billing_currency: "INR". Jika Adaptive Currency dinonaktifkan, API mengabaikan billing_currency, jadi tetapkan harga produk dalam INR.Subscription charge failed after upgrade
Subscription charge failed after upgrade
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
on_hold. Pantau webhook untuk payment.failed.