Mitra Channel

Pengelolaan mitra distribusi penjualan multi-tingkat (Distributor, VAR, Affiliator, Customer Officer), pembagian kode referral unik, penentuan tarif komisi individual, serta pengaitan akun administrator portal kemitraan (/channel).

---

1. Ringkasan Mitra Channel Penjualan

Modul Mitra Channel Penjualan merupakan pusat kendali seluruh saluran distribusi dan kemitraan bisnis Fingerspot. Melalui modul ini, administrator operasional mendaftarkan entitas mitra penjualan, menempatkannya ke dalam struktur pohon hierarki yang sesuai, menerbitkan kode referral unik bagi pelanggan, serta mengonfigurasi akun login administrator portal kemitraan.

Struktur Pohon & Penjenjangan Teratur

Struktur Hierarki

Menata seluruh tingkatan mitra mulai dari Distributor Akar (Level 0), VAR Regional (Level 1), hingga Affiliator Retail (Level 2) dalam satu pohon distribusi yang tertib.

• Memastikan kejelasan garis komando atasan-bawahan tanpa tumpang tindih wilayah.
• Mencegah relasi sirkular dan lompatan level yang berpotensi merusak rantai organisasi.
• Memudahkan pemantauan jejaring mitra cabang langsung dari satu dashboard terpadu.

Atribusi Transaksi via Kode Referral

Atribusi Presisi

Setiap mitra memegang kode unik global yang diinput oleh pelanggan saat checkout di Web App Fingerspot untuk menjamin keakuratan klaim komisi.

• Menghilangkan sengketa klaim komisi antar mitra berkat validasi kode unik global.
• Mendukung penelusuran riwayat pembelian pelanggan secara transparan dan akurat.
• Menjadi dasar otomatisasi penghitungan bagi hasil berjenjang (waterfall commission).

Akses Portal Mandiri (/channel)

Portal Kemitraan

Setiap channel didukung akun administrator portal yang memungkinkan mitra memantau transaksi, mengecek saldo komisi, dan mengelola unit secara mandiri.

• Mendukung pengelolaan multi-channel dari satu akun email login yang sama.
• Menyederhanakan orientasi mitra baru dengan pembuatan akun terpadu saat registrasi.
• Meminimalkan beban kerja administrasi tim internal pusat berkat transparansi portal.

Empat Pilar Operasional Entitas Channel

Pondasi Distribusi

Setiap channel penjualan yang didaftarkan di Modul 12 menggabungkan 4 komponen operasional yang saling melengkapi:

1. Klasifikasi Tingkatan (Tipe) Penentu Posisi Level Hierarki

Menentukan kedalaman pohon kemitraan (Level 0, Level 1, atau Level 2) serta mengunci validasi atasan-bawahan yang sah di Modul 10.

2. Kode Referral Unik Kunci Atribusi Belanja Pelanggan

Kode alfanumerik yang dimasukkan pelanggan saat checkout layanan cloud di Web App untuk mengklaim promo dan mengunci alokasi komisi mitra.

3. Tarif Komisi (Override) Persentase Bagi Hasil Individual

Mewarisi tarif komisi standar dari tipenya secara otomatis, dengan fleksibilitas penetapan persentase khusus (override) jika ada perjanjian bisnis khusus.

4. Akun Admin Portal (/channel) Hak Akses Manajemen Mandiri

Akun login resmi pengelola portal mitra yang ditautkan langsung atau dibuatkan otomatis saat channel didaftarkan melalui alur Lookup.

:::caution Invarian Operasional: Keunikan Kode Referral & Proteksi Transaksi Aktif Kode Referral bersifat unik secara global di seluruh ekosistem Fingerspot Payment. Dua mitra tidak diizinkan memiliki kode referral yang sama. Begitu sebuah kode referral telah digunakan dalam transaksi pelanggan atau terhubung ke unit mesin pada Modul 09 (Pemasangan Bundling Unit), kode tersebut terkunci permanen dan tidak boleh diubah guna menjamin jejak audit komisi dan riwayat aktivasi lisensi pelanggan.

Selain itu, pengaitan akun administrator portal wajib diverifikasi melalui proses Lookup email sebelum formulir pendaftaran channel dapat disimpan. :::

---

2. Katalog Mitra Channel (/internal/channels/list)

Halaman katalog menampilkan seluruh entitas mitra penjualan yang telah terdaftar di sistem. Administrator operasional dapat memantau kode referral, menelusuri garis atasan (Induk Channel), mengecek kustomisasi tarif komisi, serta membuka profil detail mitra untuk pengelolaan armada perangkat maupun penugasan administrator portal.

Tampilan 01: Tabel Katalog Mitra Channel Penjualan

Daftar seluruh mitra penjualan resmi terdaftar lengkap dengan Kode Referral, Nama Channel, Tipe Channel, Induk Channel, Email Bisnis, Nomor Telepon, Kustomisasi Tarif Komisi, dan Status Operasional.

Fokus Perhatian:

• Kode Referral Unik: Menampilkan kode pengenal channel (misalnya: "DIST-JKT-01", "SBY01-CO-01", "VAR-SBY-02") yang dipakai pelanggan saat checkout.
• Nama Channel Resmi: Identitas resmi badan usaha distributor, toko rekanan, perwakilan cabang, atau nama perorangan mitra.
• Tipe Channel: Klasifikasi kemitraan (Distributor Utama, VAR, Affiliator, Customer Officer) yang menentukan hak dan level hierarki.
• Induk Channel (Parent): Nama mitra atasan langsung dalam struktur pohon hierarki; menampilkan strip (—) untuk Distributor Level 0.
• Tarif Komisi Override: Menampilkan persentase komisi khusus jika mitra mendapatkan perlakuan khusus (misal: 15%), atau strip (—) jika mengikuti tarif standar bawaan.
• Lencana Status Operasional: Status keaktifan mitra dengan lencana berwarna hijau (Aktif) atau abu-abu (Tidak Aktif).
• Tombol Daftarkan Channel: Tombol aksi utama di pojok kanan atas untuk membuka formulir pendaftaran mitra baru beserta penugasan akun portal.

Elemen Antarmuka & Tindakan Cepat Katalog Channel

Tabel katalog dirancang untuk memberikan kendali komprehensif terhadap jejaring distribusi kemitraan:

1. Pemetaan Induk & Hierarki

Kolom Induk Channel memperlihatkan garis atasan langsung mitra, memudahkan verifikasi apakah sub-distributor (VAR) atau agen (Affiliator) telah terhubung ke atasan yang tepat.

2. Informasi Kontak Bisnis

Alamat email bisnis dan nomor telepon seluler/WhatsApp ditampilkan langsung pada setiap baris untuk mempermudah koordinasi operasional cepat dengan penanggung jawab mitra.

3. Navigasi Halaman Detail Mitra

Mengklik baris data pada tabel akan membuka halaman rincian detail mitra (/internal/channels/[id]) untuk memantau log transaksi referral, daftar unit terpasang, dan daftar akun admin portal.

4. Paginasi Server Fleksibel

Tabel mendukung paginasi server dengan pilihan 25, 50, atau 100 baris per halaman, menjamin kinerja navigasi tetap lancar saat menangani ribuan agen pemasaran retail.

---

3. Form Pendaftaran Channel & Akun Portal (/internal/channels/new)

Formulir pendaftaran dirancang secara terintegrasi untuk mendaftarkan entitas mitra penjualan sekaligus menetapkan akun pengelola portal kemitraan. Antarmuka formulir terbagi rapi ke dalam dua panel utama: Seksi Informasi Dasar & Profil Channel serta Seksi Akun Administrator Portal yang dilengkapi fitur verifikasi email (Lookup).

Tampilan 02: Formulir Pendaftaran Mitra Channel & Penugasan Akun Portal

Antarmuka registrasi mitra penjualan terpadu dengan seleksi tipe kemitraan dinamis, pengaturan relasi atasan, dan panel pencarian (Lookup) akun administrator portal.

Fokus Perhatian:

• Panel Informasi Dasar: Pemilihan Tipe Channel (otomatis menampilkan tingkatan level), Showroom Terkait (untuk staf gerai), dan Induk Channel (untuk sub-distributor/agen).
• Penyesuaian Formulir Dinamis: Pemilihan tipe mitra akar (Distributor) otomatis menyembunyikan pilihan showroom dan induk channel, sedangkan tipe Customer Officer mewajibkan showroom.
• Identitas & Kode Referral: Input Nama Channel resmi, Alamat Email bisnis, Kontak Telepon, dan Kode Referral unik yang akan dimasukkan pembeli saat bertransaksi.
• Kustomisasi Komisi (%): Input override persentase komisi individual opsional jika mitra memiliki kesepakatan komersial khusus di luar tarif standar tipenya.
• Panel Akun Administrator Portal: Input Admin Email disertai tombol aksi "Lookup" untuk memeriksa status keberadaan akun pengelola di database identitas.
• Tombol Aksi Submit: Tombol "Register Channel" dilindungi dan dinonaktifkan hingga proses Lookup akun administrator portal selesai diverifikasi.

Panduan Kolom Profil & Struktur Channel

Panel Profil Bisnis

Berikut panduan spesifikasi tipe input, tingkat keharusan pengisian, dan petunjuk operasional untuk panel pertama formulir:

Spesifikasi 8 Kolom Profil & Struktur Channel

Nama Kolom / Input	Tipe Data	Status	Panduan Pengisian & Ketentuan
Tipe Channel	Pilihan Dropdown (Tingkatan Kemitraan)	Wajib	Pilihan klasifikasi tingkatan kemitraan dari Modul 10 (misalnya: Distributor Utama, Value Added Reseller, Affiliator, atau Customer Officer). Menentukan posisi level hierarki mitra, tarif komisi standar bawaan, serta membuka field showroom atau induk channel yang relevan. Tip: Pilih tipe channel terlebih dahulu karena pilihan ini secara otomatis menentukan apakah kolom Showroom Terkait atau Induk Channel wajib diisi.
Induk Channel (Parent)	Pilihan Dropdown (Mitra Atasan)	Kondisional	Mitra atasan langsung dalam pohon distribusi yang menaungi channel ini. Menentukan jalur eskalasi pembagian komisi berjenjang (waterfall). Pilihan hanya menampilkan mitra aktif yang memiliki level hierarki lebih kecil (atasan yang sah). (Wajib untuk level > 0 (Sub-Channel)) Tip: Untuk mitra Distributor Utama (Level 0), kolom ini disembunyikan otomatis oleh sistem karena distributor bertindak sebagai akar utama (root) hierarki tanpa atasan.
Showroom Terkait	Pilihan Dropdown (Gerai Showroom Cabang)	Kondisional	Kantor cabang atau gerai fisik resmi dari Modul 11 tempat mitra ditugaskan sebagai staf operasional lapangan. Seluruh transaksi pelanggan yang berbelanja melalui referral staf ini akan tercatat ke performa gerai showroom tersebut. (Wajib untuk tipe Customer Officer (CO)) Tip: Wajib dipilih saat mendaftarkan profil Customer Officer (CO). Untuk tipe channel selain CO, kolom ini bersifat opsional.
Nama Channel	Teks (Nama Resmi Mitra / Toko)	Wajib	Nama resmi badan usaha distributor, toko rekanan, perwakilan cabang, atau nama lengkap mitra perorangan (misalnya: "Distributor Jakarta Pusat", "PT Solusi Prima Integrator", atau "Budi Santoso - Agen Jatim"). Tercantum pada dokumen transaksi dan laporan komisi. Tip: Gunakan nama resmi yang informatif mencakup nama kota atau wilayah agar tim operasional mudah mengidentifikasi cakupan kerja mitra.
Kode Referral	Teks Alfanumerik Unik (Kode Checkout Pelanggan)	Kondisional	Kode pengenal unik mitra yang dimasukkan pelanggan pada saat checkout di Web App Fingerspot untuk mengklaim promo. Kode ini mengunci atribusi transaksi secara langsung ke dompet komisi mitra pemilik kode. (Wajib untuk sub-channel / mitra pemasar) Tip: Gunakan kombinasi huruf kapital dan angka tanpa spasi (contoh: DIST-JKT-01, VAR-SBY-02, AFF-JATENG-99). Kode wajib bersifat unik secara global di seluruh sistem.
Alamat Email Bisnis	Format Email Valid	Opsional	Alamat surat elektronik kontak resmi entitas mitra (misalnya: kontak@distributor-jkt.co.id) untuk keperluan surat-menyurat resmi, pengiriman nota komisi bulanan, dan pemberitahuan program kemitraan. Tip: Email ini adalah kontak korespondensi bisnis entitas channel dan dapat berbeda dari Email Akun Administrator Portal.
Nomor Telepon	Format Nomor Telepon (+62 / 08...)	Opsional	Nomor kontak telepon atau WhatsApp penanggung jawab bisnis mitra channel (misalnya: +6281234567890) untuk koordinasi cepat staf operasional pusat dengan mitra cabang. Tip: Gunakan awalan format internasional (+62) agar nomor telepon dapat langsung dihubungi melalui pesan instan WhatsApp.
Kustomisasi Tarif Komisi (%)	Persentase Angka (0 – 100%)	Opsional	Persentase komisi khusus (override rate) yang berlaku khusus untuk mitra ini. Jika diisi, persentase ini menggantikan tarif komisi bawaan dari Tipe Channel (Modul 10). Jika dikosongkan, mitra otomatis menggunakan tarif standar tipenya. Tip: Hanya diisi jika terdapat perjanjian bagi hasil khusus yang disetujui manajemen. Kosongkan nilai ini jika mitra mengikuti persentase standar tingkatan kemitraannya.

Panduan Kolom Akun Administrator Portal Kemitraan

Panel Akun Login Portal

Panel kedua formulir mengatur pembuatan atau pengaitan kredensial login akun pengelola portal mitra (/channel):

Spesifikasi Kolom Akun Administrator Portal

Nama Kolom / Input	Tipe Data	Status	Panduan Pengisian & Ketentuan
Admin Email	Format Email Valid (Kunci Lookup Akun)	Wajib	Alamat email yang digunakan sebagai kredensial login utama akun pengelola ke portal mandiri mitra (/channel). Berfungsi sebagai kata kunci pencarian akun via tombol "Lookup" sebelum form registrasi dapat disimpan. Tip: Pastikan memasukkan alamat email yang aktif dan valid, karena akun ini akan memegang kendali atas portal dashboard mitra channel.
Admin Name	Teks (Nama Lengkap Pengelola)	Kondisional	Nama lengkap personil yang mengoperasikan akun portal mitra. Jika email yang dicari sudah terdaftar di sistem, kolom ini otomatis menampilkan nama pemilik akun. Jika belum terdaftar, kolom terbuka dan secara bawaan terisi nama channel namun dapat disunting manual. (Wajib jika akun baru (otomatis terisi jika akun lama)) Tip: Ketik nama lengkap penanggung jawab operasional mitra (contoh: "Ahmad Rizky Pratama") agar mudah dikenali dalam log audit aktivitas.
Password & Konfirmasi Password	Kata Sandi Rahasia (Minimal 8 Karakter)	Kondisional	Kata sandi rahasia untuk mengamankan hak akses login akun pengelola portal mitra. Dilengkapi kolom konfirmasi untuk mencegah kesalahan pengetikan sandi. Jika akun sudah ada di database sistem (Kasus A), kolom password tidak muncul karena menggunakan sandi lama yang sudah aktif. (Hanya wajib diisi jika akun belum terdaftar di sistem) Tip: Gunakan kombinasi minimal 8 karakter yang mengandung huruf besar, huruf kecil, dan angka demi keamanan hak akses portal kemitraan.

:::info Petunjuk Operasional: Logika Penyesuaian Kolom Form Sesuai Tipe Channel Formulir pendaftaran channel menggunakan logika kondisional dinamis berdasarkan Tipe Channel yang dipilih:

• Jika memilih Distributor (Root / Level 0): Pilihan Showroom Terkait dan Induk Channel otomatis disembunyikan dan diatur kosong oleh sistem karena distributor adalah akar hierarki.
• Jika memilih Customer Officer (CO / Staf Lapangan): Pilihan Showroom Terkait menjadi wajib diisi, sedangkan Induk Channel dan Kustomisasi Komisi dinonaktifkan karena staf lapangan terikat pada showroom penugasan.
• Jika memilih Sub-Channel (Level > 0): Pilihan Induk Channel menjadi wajib dipilih, dan daftar opsi hanya menampilkan mitra atasan yang berstatus aktif dengan level lebih rendah. :::

---

4. Alur Pembuatan & Pengaitan Akun Admin Portal

Setiap mitra channel penjualan membutuhkan akun administrator untuk mengakses Portal Mandiri Kemitraan (/channel). Melalui portal tersebut, mitra dapat memantau pergerakan transaksi referral pelanggan, mengecek rincian komisi, dan mengelola staf operasionalnya.

Untuk mempermudah manajemen akun tanpa perlu membuka modul pengguna terpisah, formulir pendaftaran dilengkapi sistem Verifikasi Akun Otomatis (Lookup). Sistem ini secara cerdas membedakan antara pengelola lama yang mengelola banyak channel sekaligus (multi-channel scope) dengan mitra baru yang belum memiliki akun sama sekali.

Mekanisme Verifikasi Tombol "Lookup"

Alur Dua Cabang

Operator memasukkan alamat email calon pengelola di kolom Admin Email lalu menekan tombol Lookup (Cari). Sistem langsung menelusuri database pengguna identitas pusat:

KASUS A: Akun Ditemukan User Sudah Terdaftar Tautkan Hak Akses Baru ke Akun yang Sudah Ada

Terjadi apabila alamat email yang dimasukkan telah terdaftar di database identitas. Sistem tidak meminta password baru, melainkan menampilkan kartu profil akun terdaftar:

👤 Ahmad Pratama ahmad.pratama@distributor.com Active Channel Assignments: 🏢 Distributor Jawa Timur Utama 🏢 Showroom Surabaya ITC

Prosedur Tindakan Admin:

• Periksa nama dan daftar channel aktif yang saat ini dipegang untuk memastikan pemilik akun tepat.
• Tidak perlu memasukkan password; akun akan menggunakan kata sandi lamanya.
• Sistem otomatis menautkan channel baru ke akun ini (channel scope linking).
• Jika keliru memasukkan email, klik tombol Change Email untuk reset pencarian.

KASUS B: Akun Belum Ada Registrasi User Baru Pembuatan Akun Login Otomatis Bersama Channel

Terjadi apabila email yang dimasukkan belum pernah terdaftar di database identitas. Sistem menampilkan kotak informasi dan membuka field pembuatan akun baru:

ℹ Akun belum terdaftar. Lengkapi formulir di bawah untuk membuat akun login baru.

Email: (Terkunci)

Admin Name: Terisi otomatis

Password: Wajib diisi

Konfirmasi: Wajib cocok

Prosedur Tindakan Admin:

• Kolom Admin Name otomatis terisi dengan Nama Channel, namun admin disarankan menyesuaikan dengan nama lengkap personil asli.
• Masukkan Password dan Confirm Password yang kuat (minimal 8 karakter).
• Saat tombol Register Channel diklik, sistem secara atomik mendaftarkan akun baru ke database identitas sekaligus menugaskannya ke channel ini.
• Jika terdapat kesalahan ketik alamat email, klik Change Email untuk membatalkan dan mengulang.

Proteksi Tombol Aksi "Register Channel"

Validasi Ketat

Demi mencegah terciptanya entitas channel tanpa pengelola (orphaned channel), sistem menerapkan aturan proteksi pada tombol simpan:

1. Status Awal: Tombol Dinonaktifkan

Selama operator belum menekan tombol "Lookup" pada panel akun administrator, tombol simpan berada dalam kondisi nonaktif (disabled).

2. Verifikasi Sukses: Tombol Aktif

Tombol "Register Channel" hanya akan aktif setelah status akun terverifikasi (baik Kasus A maupun Kasus B telah dilengkapi seluruh kolom wajibnya).

3. Transaksi Atomik Terpadu

Pembuatan data mitra channel dan akun administrator dieksekusi secara serentak, menjamin mitra langsung memiliki akun login aktif sejak detik pertama dibuat.

Checklist Verifikasi Admin Sebelum Menyimpan Mitra Channel:

• Kesesuaian Tipe & Atasan: Pastikan mitra turunan (Level 1 atau 2) memilih Induk Channel yang sah dan berstatus aktif. Untuk Distributor (Level 0), biarkan tanpa atasan.
• Keunikan Kode Referral: Pastikan kode referral mitra belum pernah digunakan oleh channel lain di seluruh sistem Fingerspot.
• Showroom untuk Customer Officer: Pastikan profil staf gerai / CO telah ditautkan ke gerai Showroom Cabang resmi tempat bertugas.
• Verifikasi Lookup Akun: Pastikan tombol "Lookup" telah diklik dan status akun telah terkonfirmasi (Kasus A atau Kasus B).
• Kredensial Password Aman: Jika membuat akun baru (Kasus B), pastikan kata sandi yang dibuat memenuhi standar keamanan dan telah dicatat untuk diserahkan kepada pihak mitra.