Skip to main content

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.
Dompet Pelanggan ≠ Penagihan Berbasis KreditCustomer Wallets menyimpan uang nyata yang diterapkan Dodo Payments ke tagihan langganan.Untuk melacak unit penggunaan virtual seperti panggilan API, token, atau jam komputasi, gunakan Credit-Based Billing.
Customer Wallets

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 memiliki currency 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 filter currency 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.
Kelola dana USD untuk pelanggan yang berbasis di AS.
Kelola dana EUR untuk pelanggan yang berbasis di Eropa.
Kelola dana GBP untuk pelanggan yang berbasis di Inggris Raya.

Praktik Terbaik

Cegah Transaksi Duplikat

Kirim idempotency_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.
Mulailah dengan pendanaan dan pengurangan dasar, lalu otomatisasi lebih banyak alur kerja penagihan Anda seiring pertumbuhan bisnis.
Terakhir diubah pada 26 September 2026