Get Customer Wallets
Dapatkan saldo pelanggan dalam setiap mata uang.
Create Ledger Entry
Tambahkan dana ke atau kurangi dana dari wallet.
List Ledger Entries
Telusuri setiap transaksi wallet berdasarkan halaman.
Apa Itu Wallet Pelanggan?
Wallet pelanggan menyimpan uang nyata untuk pelanggan, dengan satu saldo untuk setiap mata uang. Gunakan wallet untuk:- Menyimpan dana prabayar untuk pembayaran langganan mendatang
- Menangani pengembalian dana sebagai saldo wallet, bukan pengembalian dana ke kartu
- Mengeluarkan saldo promosi, seperti bonus sambutan atau reward loyalitas
- Menerapkan dana wallet ke tagihan langganan secara otomatis saat penagihan
- Melacak setiap transaksi dalam ledger dengan saldo sebelum dan sesudah transaksi
Anda tidak perlu membuat wallet sendiri. Wallet pelanggan untuk suatu mata uang dibuat dengan saldo nol saat pertama kali Anda menambahkan entri ledger dalam mata uang tersebut. Sampai saat itu, Get Customer Wallets tidak mengembalikan entri untuk mata uang tersebut.

Cara Kerjanya
Saat langganan diperpanjang atau perubahan paket menghasilkan tagihan, Dodo Payments terlebih dahulu menerapkan saldo wallet pelanggan dalam mata uang tersebut, lalu menagih metode pembayaran untuk sisanya. Jika saldo hanya mencakup sebagian tagihan, wallet membayar bagian tersebut.Penyiapan Otomatis
Anda tidak perlu menyiapkan apa pun. Tambahkan entri ledger melalui API, atau klik Apply Credit/Debit pada tab Wallets pelanggan di dashboard, dan wallet untuk mata uang tersebut siap digunakan.Dukungan Multi-Mata Uang
Setiap mata uang memiliki saldo sendiri. Setiap wallet dalam respons Get Customer Wallets memilikicurrency dan balance dalam unit mata uang terkecil, dan respons tersebut menambahkan total_balance_usd, yaitu jumlah semua saldo yang dikonversi ke USD. Entri ledger menerima mata uang berikut:
integer
Saldo dalam Dolar AS (disimpan dalam sen)
integer
Saldo dalam Euro (disimpan dalam sen)
integer
Saldo dalam Pound Sterling (disimpan dalam pence)
Wallet pelanggan menyimpan saldo USD, EUR, dan GBP. Wallet INR native yang dihentikan seperti dijelaskan dalam Payout Structure adalah wallet pembayaran Anda sebagai merchant, bukan wallet pelanggan. INR juga tetap didukung sebagai mata uang transaksi untuk langganan UPI, RuPay, dan kartu India.
Bekerja dengan Dompet
Memeriksa Saldo Pelanggan
Dapatkan saldo pelanggan dalam setiap mata uang, misalnya untuk mengonfirmasi saldo sebelum pembelian atau menampilkannya di aplikasi Anda.Get Customer Wallet Balances
Dapatkan saldo wallet pelanggan dalam semua mata uang.
Menambah atau Mengurangi Dana
Tambahkan dana, seperti bonus sambutan atau saldo pengembalian dana, atau kurangi dana, seperti tagihan manual.entry_type, currency, dan amount wajib diisi. amount adalah bilangan bulat positif dalam unit mata uang terkecil. Tambahkan reason (hingga 500 karakter) untuk audit trail Anda, dan idempotency_key untuk mencegah duplikasi. Responsnya adalah wallet yang telah diperbarui.
entry_type bernilai 'credit' untuk menambahkan dana ke wallet dan 'debit' untuk mengurangi dana darinya. Debit yang lebih besar daripada saldo akan gagal dengan 400.Create Customer Wallet Ledger Entry
Tambahkan dana ke atau kurangi dana dari wallet pelanggan.
Melihat Riwayat Transaksi
Daftarkan setiap credit dan debit untuk pelanggan, dengan pagination dan filtercurrency opsional. Setiap entri memiliki event_type (payment, payment_reversal, refund, refund_reversal, dispute, dispute_reversal, atau merchant_adjustment), amount, serta before_balance dan after_balance. Gunakan ledger untuk merekonsiliasi akun dan menjawab pertanyaan pelanggan.
List Customer Wallet Ledger Entries
Daftarkan setiap transaksi wallet untuk pelanggan.
Contoh di Dunia Nyata
Contoh-contoh ini menggunakan TypeScript SDK.client adalah client DodoPayments yang dibuat seperti dalam Integration Guide.
Pengembalian Dana ke Wallet
Untuk mengembalikan dana kepada pelanggan sebagai saldo wallet, bukan ke kartu mereka, tambahkan jumlah tersebut dengan entri credit. Dana tetap berada di bisnis Anda untuk pembelian pelanggan berikutnya.Credit ledger tidak mengembalikan pembayaran asli. Saat Anda mengembalikan pembayaran melalui Refunds API, Dodo Payments secara otomatis mengembalikan bagian yang dibayar wallet ke wallet.
Bonus Sambutan / Saldo Promosi
Berikan bonus sambutan kepada pelanggan baru untuk mendorong pembelian pertama mereka.Pembayaran Langganan dari Wallet
Kurangi dana dari wallet untuk membayar tagihan yang Anda buat sendiri. Perpanjangan tidak memerlukan langkah ini karena Dodo Payments menerapkan saldo ke perpanjangan secara otomatis.Sistem Penagihan Prabayar
Biarkan pelanggan mendanai akun mereka di awal dan menggunakan saldo tersebut secara bertahap.customerId, paymentId, dan purchaseId adalah identifier Anda sendiri untuk pelanggan, deposit, dan pembelian.
1
Add Initial Funds
Tambahkan dana ke wallet pelanggan saat mereka melakukan deposit.
2
Apply Balance to Purchases
Kurangi saldo saat pelanggan menggunakan layanan Anda.
3
Monitor Balances
Periksa apakah dana pelanggan mulai menipis, lalu minta mereka melakukan top-up.
Dukungan Multi-Mata Uang
Pertahankan saldo terpisah untuk pelanggan di berbagai wilayah.US Customers
US Customers
Kelola dana USD untuk pelanggan yang berbasis di AS.
European Customers
European Customers
Kelola dana EUR untuk pelanggan yang berbasis di Eropa.
UK Customers
UK Customers
Kelola dana GBP untuk pelanggan yang berbasis di Inggris Raya.
Praktik Terbaik
Cegah Transaksi Duplikat
Kirimidempotency_key yang diturunkan dari peristiwa yang menyebabkan entri, seperti ID pesanan atau pembayaran, sehingga percobaan ulang tidak menambahkan atau mengurangi dana dua kali. Jika Anda mengulangi permintaan dengan key yang sama, Dodo Payments tidak membuat entri baru dan mengembalikan wallet saat ini.
Periksa Saldo Sebelum Menagih
Sebelum mengurangi jumlah besar dari wallet, pastikan saldo mencukupinya.Apa yang Akan Hadir Selanjutnya
Wallet pelanggan tidak mendukung fitur-fitur berikut:- Kedaluwarsa Saldo: Dana wallet tidak kedaluwarsa.
- Analytics: Tidak ada laporan pengeluaran atau tren saldo. Gunakan ledger untuk membuatnya sendiri.
- Webhooks: Tidak ada webhook yang dipicu saat saldo berubah, dan tidak ada peringatan saldo rendah. Untuk melacak perubahan, daftarkan entri ledger.