---
title: Auto top-up
description: Isi saldo dompet pelanggan otomatis dari kartu tersimpan atau PayPal — mode berbasis pemakaian dan tetap, batas global, serta penanganan kegagalan.
url: https://nexcmp.com/id/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Auto top-up {#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 {#what-it-does}

Saat saldo dompet pelanggan turun terlalu rendah, NexCMP menagih [saved payment method](https://nexcmp.com/id/docs/billing/saved-payment-methods/) 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 {#requirements}

| Item | Persyaratan |
|---|---|
| Saluran | [Stripe](https://nexcmp.com/id/docs/billing/stripe/) dan/atau [PayPal](https://nexcmp.com/id/docs/billing/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 {#how-it-works}

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](https://nexcmp.com/id/docs/billing/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](https://nexcmp.com/id/docs/billing/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 {#configure-the-global-limits}

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**.

![Bagian auto top-up pada halaman Fees and limits dengan sakelar global dan batas harian](https://nexcmp.com/id/docs/images/billing/auto-top-up-01-limits.webp)

## Tampilan pelanggan {#what-the-customer-sees}

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.

![Pengaturan penagihan pelanggan dengan pengisian otomatis dalam mode By usage dan riwayat pengisian otomatis terbaru](https://nexcmp.com/id/docs/images/billing/auto-top-up-02-portal.webp)

## Verifikasi {#verify}

1. Sebagai pelanggan uji, lakukan pengisian saldo pertama dengan kartu uji ([Stripe](https://nexcmp.com/id/docs/billing/stripe/#verify)). 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 {#limits-notes}

- **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 {#troubleshooting}

| 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. |