Menu
Masuk

Manajemen Agent

Panduan lengkap mengelola agent, reseller, dan sistem komisi penjualan voucher

Reseller Komisi Utang/Piutang Topup Saldo Laporan Penjualan

Apa itu Agent?

Agent adalah akun reseller yang memiliki kewenangan untuk membuat dan menjual voucher internet kepada pelanggan akhir. Sistem agent dirancang untuk mempermudah distribusi voucher dengan sistem komisi otomatis.

Karakteristik Agent:

  • Memiliki username dan password sendiri untuk login ke sistem
  • Memiliki balance (utang) yang tercatat di sistem
  • Dapat membuat voucher dari profile yang tersedia
  • Mendapatkan komisi otomatis dari setiap voucher yang terjual
  • Dapat melihat laporan penjualan sendiri
Catatan Penting: Agent berbeda dengan admin. Agent hanya bisa membuat voucher dan melihat laporannya sendiri, tidak bisa mengatur profile, NAS, atau agent lain.

Konsep Balance (Utang) Agent

Balance agent = TOTAL UTANG agent ke admin. Bukan saldo yang bisa dipakai, melainkan catatan berapa banyak agent harus membayar ke admin.

Balance Bertambah (+)

Saat voucher yang dibuat agent terpakai oleh pelanggan, balance otomatis bertambah sesuai Cost Price profile.

Balance Baru = Balance Lama + Cost Price

Balance Berkurang (-)

Saat agent membayar utang ke admin, admin mengurangi balance sesuai nominal pembayaran.

Balance Baru = Balance Lama - Pembayaran

Contoh Perhitungan Balance:
Skenario Balance Awal Kejadian Balance Akhir
Penjualan voucher 0 Agent jual 10 voucher (Cost @5.000) +50.000
Pembayaran agent 50.000 Agent bayar 30.000 20.000
Penjualan lanjutan 20.000 Agent jual 5 voucher (Cost @5.000) 45.000

Flow Sistem Agent

Diagram Flow Sistem Agent

netlayer.id flow agents
Keuntungan Sistem Agent:
  • Admin tidak perlu membuat voucher satu per satu
  • Agent bisa menjual voucher dengan harga fleksibel (keuntungan agent = Sale Price - Cost Price)
  • Sistem mencatat otomatis semua transaksi
  • Laporan komisi agent akurat dan real-time

Menu Agent

Agents Add
Menu Fungsi Akses URL
Agents Menampilkan daftar semua agent, balance, dan aksi edit/hapus /radius/agents
Add Form untuk menambahkan agent baru /radius/agents/add

Cara Menambah Agent Baru

Langkah-langkah menambahkan agent baru ke sistem:

  1. Login sebagai Admin
  2. Buka menu Radius → Agents → Add atau langsung akses /radius/agents/add
  3. Isi form dengan data agent:
Field Keterangan Wajib? Contoh
Name Nama lengkap agent (untuk identifikasi) Ya Agen Madura atau Reseller A
Phone Nomor telepon agent untuk komunikasi Opsional 08123456789
Address Alamat lengkap agent Opsional Jl. Raya No. 123, Jakarta
Username Username untuk login agent ke sistem Ya agen_madura (unique)
Password Password untuk login agent Ya rahasia123
Balance Utang awal agent (biasanya diisi 0) Opsional 0
Penting:
  • Field Balance diisi 0 saat pertama membuat agent
  • Username harus unik, tidak boleh sama dengan agent lain atau admin
  • Agent akan menggunakan credential ini untuk login ke /auth/login

Cara Mengedit Data Agent

  1. Buka menu Radius → Agents atau /radius/agents
  2. Klik ikon (Settings) pada agent yang akan diedit
  3. Ubah data yang diperlukan pada form edit
  4. Klik tombol Edit untuk menyimpan perubahan
Field yang bisa diedit:
  • Name - Nama agent
  • Phone - Nomor telepon
  • Address - Alamat
  • Username - Username login (ubah jika perlu)
  • Password - Password login (ganti jika agent lupa)
  • Balance - Untuk mencatat pembayaran (KURANGI balance)

Cara Mencatat Pembayaran dari Agent

Ketika agent membayar utangnya ke admin, admin harus MENGURANGI balance agent. BUKAN menambah!

Langkah-langkah:

  1. Buka menu Radius → Agents atau /radius/agents
  2. Klik ikon (Settings) pada agent yang membayar
  3. Cari field Balance
  4. Isi dengan nilai SISA UTANG SETELAH PEMBAYARAN
  5. Klik tombol Edit untuk menyimpan
Contoh Perhitungan:
Skenario Balance Saat Ini Agent Membayar Balance Diisi
Pembayaran 1 150.000 100.000 50.000
Lunas 50.000 50.000 0
Pembayaran sebagian 200.000 75.000 125.000
Kesalahan Umum:

Jangan mengisi Balance dengan jumlah yang dibayarkan (misal bayar 100.000 diisi 100.000). Itu SALAH! Isi dengan SISA UTANG.

Bagaimana Balance Bertambah Otomatis?

Balance agent akan bertambah secara otomatis oleh sistem tanpa campur tangan admin. Ini terjadi saat:

  • Voucher yang dibuat oleh agent pertama kali digunakan (login) oleh pelanggan
  • Penambahan balance sesuai dengan cost price dari profile voucher yang digunakan
Contoh Skenario:
Tahap Balance Agent Keterangan
Balance awal 0 Agent baru dibuat, belum ada utang
Buat 10 voucher 0 Membuat voucher tidak mengubah balance
5 voucher terpakai +25.000 Cost price @5.000 x 5 = 25.000
5 voucher sisanya terpakai +50.000 Total balance = 50.000
Detail Teknis: Sistem memeriksa field expire == 0 pada secret. Jika 0 (belum pernah dipakai), maka setelah autentikasi berhasil, sistem akan mengupdate expire dan menambah balance agent.

Perbedaan Cost Price vs Sale Price

Aspek Cost Price (Harga Pokok) Sale Price (Harga Jual)
Dampak ke Agent Menambah balance agent (utang) Tidak mempengaruhi balance agent
Dampak ke Admin Pendapatan admin (dasar) Harga jual ke pelanggan
Untuk Agent Harga agent ke admin (modal) Harga agent ke pelanggan
Contoh Rp 5.000 Rp 10.000
Keuntungan Agent Sale Price - Cost Price = Rp 5.000
Tips Bisnis: Atur Cost Price lebih rendah dari Sale Price agar agent mendapatkan keuntungan. Semakin besar selisihnya, semakin termotivasi agent untuk menjual.

Laporan Transaksi Agent

Setiap transaksi penjualan voucher oleh agent akan tercatat di menu Reports. Informasi yang tersedia:

Kolom Keterangan
Username Username voucher yang digunakan
Agent Nama agent yang menjual voucher
Profile Paket yang dibeli pelanggan
Cost Price Harga pokok (utang agent ke admin)
Sale Price Harga jual agent ke pelanggan
Time Waktu voucher pertama kali digunakan
Lihat Laporan Transaksi

Cara Menghapus Agent

  1. Buka menu Radius → Agents atau /radius/agents
  2. Klik ikon (Settings) pada agent yang ingin dihapus
  3. Klik tombol Delete (warna merah)
  4. Konfirmasi penghapusan dengan klik OK
Peringatan:
  • Menghapus agent akan menghapus SEMUA data agent (nama, kontak, username, password)
  • Menghapus agent TIDAK akan menghapus voucher yang sudah dibuat oleh agent tersebut
  • Menghapus agent TIDAK akan menghapus laporan transaksi agent tersebut
  • Data balance (utang) agent akan hilang, pastikan agent sudah lunas sebelum dihapus

Daftar Agent

Menu Agents (/radius/agents) menampilkan tabel dengan informasi:

Kolom Keterangan Aksi
Tombol untuk edit/hapus agent dan catat pembayaran Klik untuk mengubah data agent
Name Nama agent (identifikasi) -
Phone Nomor telepon agent -
Username Username untuk login agent -
Balance Total utang agent ke admin (warna hijau jika >0) Digunakan untuk tagihan

Akses Agent (Cara Login sebagai Agent)

Setelah agent dibuat, agent dapat login ke sistem melalui halaman /auth/login menggunakan credential yang diberikan admin.

Credential Agent:

Username: agen_madura
Password: ******** (sesuai yang didaftarkan)

Yang Bisa Dilakukan Agent:
  • Membuat voucher (manual atau generate massal)
  • Melihat daftar voucher yang dibuat
  • Mencetak voucher
  • Melihat laporan transaksi sendiri
  • Tidak bisa mengelola profile, NAS, atau agent lain

Ringkasan Balance Agent

Aksi Pengaruh ke Balance Yang Melakukan Waktu Terjadi
Voucher terpakai Bertambah (+) sesuai Cost Price Sistem otomatis Saat pelanggan login pertama kali
Agent membayar utang Berkurang (-) sesuai pembayaran Admin (input manual) Saat agent melakukan pembayaran
Membuat voucher Tidak berubah Agent/Admin Saat pembuatan voucher
Voucher expired Tidak berubah Sistem otomatis Setelah melewati masa berlaku

Troubleshooting Agent

Balance agent tidak bertambah

Pastikan voucher yang dibuat agent memiliki profile dengan Cost Price > 0. Cek juga apakah voucher benar-benar sudah dipakai pelanggan.

Agent tidak bisa login

Cek username dan password. Pastikan agent tidak dihapus oleh admin.

Keuntungan agent salah

Cek Cost Price dan Sale Price di profile yang digunakan. Pastikan selisihnya sesuai yang diinginkan.

Balance minus

Balance seharusnya tidak minus. Jika terjadi, cek apakah admin salah input saat mencatat pembayaran.

Laporan agent tidak muncul

Pastikan voucher sudah benar-benar digunakan pelanggan. Cek di menu Sessions untuk memastikan.

Agent tidak bisa membuat voucher

Pastikan ada profile yang tersedia dan agent memiliki akses. Cek juga apakah sistem dalam mode maintenance.

Best Practices Manajemen Agent

  • Buat struktur komisi yang jelas - Tentukan Cost Price dan Sale Price sebelum merekrut agent
  • Catat pembayaran segera - Setiap agent membayar, segera update balance untuk menghindari kesalahan
  • Pantau balance secara berkala - Cek agent dengan balance terbesar untuk ditagih
  • Gunakan laporan untuk evaluasi - Lihat agent mana yang paling produktif
  • Komunikasikan secara rutin - Beri tahu agent tentang promo atau paket baru
  • Backup data agent - Simpan daftar agent dan kontaknya untuk keamanan
  • Beri insentif - Agent dengan penjualan tinggi bisa diberi bonus atau diskon Cost Price

Cheatsheet Agent

Aksi URL / Langkah
Lihat daftar agent /radius/agents
Tambah agent baru /radius/agents/add
Edit agent / catat pembayaran Klik pada agent
Hapus agent Klik → Delete
Login sebagai agent /auth/login dengan username agent
Lihat laporan agent /radius/reports
Kelola Agent Tambah Agent Baru Kembali ke Beranda