Auto top-up

Lokasi di admin: Finance › Payment channels › Fees & limits (/payments/fees), kartu Wallet & top-up (Billing › Policy), bagian Auto top-up (Stripe / PayPal). Lokasi di portal: Billing › Settings (/billing?settings=1).

Fungsi

Saat saldo dompet pelanggan turun terlalu rendah, NexCMP menagih saved payment method milik mereka dan mengkreditkannya ke dompet, sehingga layanan yang berjalan tidak ditangguhkan karena kekurangan dana. Pekerjaan latar belakang memeriksa semua pelanggan yang diaktifkan setiap 5 menit.

Persyaratan

Item	Persyaratan
Saluran	Stripe dan/atau PayPal dikonfigurasi.
Saved method	Pelanggan memiliki kartu atau akun PayPal yang tersimpan.
Situs	Situs utama, atau situs reseller yang kanal Stripe/PayPal-nya dikumpulkan oleh platform.
Global switch	Auto top-up enabled dalam keadaan aktif (default aktif).

Cara kerja

Setelah pengisian saldo Stripe atau PayPal pertama pelanggan, server akan menyimpan metode pembayaran tersebut dan mengaktifkan pengisian saldo otomatis dalam mode By usage — hanya jika pelanggan tersebut belum pernah mengatur pengisian otomatis sendiri. Tidak ada kotak centang tambahan di layar deposit; server mencatat waktu, alamat IP, dan metode sebagai bukti. Jika pelanggan menonaktifkan pengisian otomatis nanti, fitur ini tidak akan pernah diaktifkan kembali secara otomatis.

Mode	Pemicu (saat saldo di bawah ...)	Jumlah yang ditagihkan
By usage (default setelah pengisian saldo pertama)	biaya untuk menjalankan layanan selama 24 jam ke depan (VM per jam ditambah perpanjangan prabayar yang jatuh tempo dalam 24 jam), namun tidak pernah di bawah $5	biaya 24 jam yang dibulatkan ke dolar terdekat, setidaknya sebesar minimum top-up, paling banyak sebesar maksimum top-up dan batas harian
Fixed amount	ambang batas milik pelanggan sendiri ($1 hingga $500)	jumlah milik pelanggan sendiri (dari minimum top-up hingga $1,000, dan lebih besar dari ambang batas)

Tanpa layanan yang berjalan dalam mode By usage, tidak ada biaya yang ditagihkan.

Saldo yang dibandingkan dengan ambang batas adalah uang riil di dompet. Kredit layanan dari kode promosi disimpan secara terpisah dan tidak dihitung (lihat Promotions).

Biaya ditangani seperti pengisian saldo normal: dengan Customer pays top-up fee aktif, kartu akan ditagih sebesar jumlah ditambah biaya dan dompet mendapatkan jumlah penuh; jika nonaktif, dompet mendapatkan jumlah dikurangi biaya.

Mengonfigurasi batas global

1. Buka Finance › Payment channels › Fees & limits (/payments/fees).

2. Di bagian Auto top-up (Stripe / PayPal), atur:

   Pengaturan	Default	Rentang	Arti
   Auto top-up enabled	On	on atau off	Off akan menghentikan setiap pembebanan latar belakang seketika.
   Ambang batas pengisian otomatis default (USD, cadangan mode tetap)	$5.00	$0 to $10,000	Hanya digunakan sebagai ambang batas awal dalam mode tetap.
   Maksimal pengisian otomatis per 24 jam per pelanggan	3	1 hingga 50	Menghitung percobaan yang berhasil dan tertunda.
   Batas jumlah pengisian otomatis per 24 jam per pelanggan (USD)	$500.00	$0 hingga $1,000,000	Total tagihan otomatis dalam satu hari berjalan.

3. Click Save Wallet & top-up.

Tampilan pelanggan

1. Di portal, pelanggan membuka Billing dan mengklik Settings.
2. Panel menampilkan metode yang disimpan, sakelar on/off, mode (By usage atau Fixed amount), perkiraan penggunaan saat ini dan tagihan berikutnya, serta Recent automatic top-ups.
3. Beralih ke Fixed amount memungkinkan mereka memasukkan ambang batas dan jumlahnya. Mematikan sakelar akan menghentikan penagihan.

Verifikasi

1. Sebagai pelanggan uji, lakukan pengisian saldo pertama dengan kartu uji (Stripe). Buka Billing › Settings: pengisian otomatis dalam keadaan aktif.
2. Jalankan VM kecil agar ada penggunaan, dan kurangi saldo di bawah ambang batas (misalnya dengan Customers › customer › Credit / debit).
3. Dalam waktu sekitar 5 menit, penagihan akan dilakukan. Pada kartu Overview › Payment milik pelanggan, Auto top-up history menunjukkan percobaan dengan status Done, dan notifikasi Top-up received dikirimkan.

Batas & catatan

• Satu tagihan per penurunan. Setelah penagihan, job menunggu hingga saldo kembali di atas ambang batas atau waktu tunggu berakhir: 1 jam setelah berhasil, 24 jam setelah tagihan tertunda, 30 menit setelah error sistem.
• Batas harian. Ketika salah satu batas harian tercapai, tidak ada penagihan yang dilakukan dan baris Daily limit reached dicatat (paling sering sekali setiap 6 jam).
• Kegagalan. Kartu yang ditolak, kartu kedaluwarsa, atau saldo tidak mencukupi dihitung sebagai kegagalan kartu. Job mencoba kembali setelah 1 jam, lalu 6 jam, lalu 24 jam. Setelah 3 kegagalan kartu berturut-turut, auto top-up dinonaktifkan dan pelanggan akan diberi tahu (Auto top-up failed). Pembayaran yang memerlukan konfirmasi pelanggan (misalnya 3-D Secure) tidak dihitung sebagai kegagalan; pelanggan diminta untuk mengonfirmasinya.
• Tidak ada penagihan ganda. Setiap tagihan diklaim secara atomik per penurunan di bawah ambang batas dan menggunakan idempotency key di gateway.
• Menghapus kartu akan menonaktifkan auto top-up.
• Reseller. Jika reseller menggunakan saluran pembayarannya sendiri, pelanggan tidak dapat mengaktifkan auto top-up (HTTP 403 feature_disabled).

Pemecahan Masalah

Gejala	Penyebab	Solusi
Pelanggan tidak dapat mengaktifkannya: "Top up once with a card or PayPal"	Tidak ada metode tersimpan	Lakukan top-up kartu atau PayPal satu kali terlebih dahulu.
Error no_card (422)	Gateway yang dipilih tidak memiliki metode tersimpan	Pilih gateway yang memilikinya, atau simpan metode.
Error invalid_argument pada nominal	Mode tetap di luar rentang yang diizinkan	Ambang batas $1–$500, nominal antara minimum top-up dan $1,000, nominal lebih besar dari ambang batas.
Tidak ada penagihan meskipun saldo rendah	Sakelar global nonaktif, tidak ada layanan berjalan dalam mode By usage, batas harian tercapai, atau penagihan sebelumnya masih menunggu	Periksa sakelar, riwayat, dan batasnya.
"N percobaan gagal berturut-turut — top-up otomatis nonaktif setelah 3 kali"	Kartu terus-menerus gagal	Pelanggan mengganti kartu dengan deposit baru.
Status Perlu konfirmasi Anda	Bank memerlukan 3-D Secure	Pelanggan menyelesaikan satu kali top-up normal.