Modul Cek ID

Update: ... minutes read

Panduan Modul Cek ID V1.3

Modul Cek ID adalah modul untuk membantu memvalidasi ID pelanggan, nomor HP, ID game, nomor meter PLN, atau akun e-wallet sebelum user lanjut melakukan pembelian produk.

Pada versi terbaru, modul Cek ID sudah mendukung pengecekan nama melalui API maupun melalui TRX. Semua pengaturan utama sekarang bisa dilakukan dari admin panel, jadi tidak perlu edit model secara manual seperti versi lama.

Fitur Utama Versi Terbaru

  • Cek nama bisa melalui API atau TRX.
  • Mode TRX cukup pilih VO ID, OP ID dan produk akan terisi otomatis dari tabel voucher.
  • API key lebih aman karena request dari user dikirim ke backend myfolder/cek_nama, bukan langsung ke URL API dari browser.
  • Request cek nama menggunakan metode POST, memakai CSRF, dan payload terenkripsi.
  • Bebas Nominal bisa tambah/hapus operator e-wallet dari admin panel.
  • Bebas Nominal mendukung setting cek nama per operator.
  • Minimal dan maksimal nominal Bebas Nominal bisa diatur dari admin.
  • Custom View bisa ditambah terus menerus dari admin panel.
  • URL gambar/logo dan loading bisa input manual atau upload gambar/gif ke folder assets/mod_cekid.
  • Tersedia setting tombol kontak, kontak favorit, dan scan barcode Token Listrik.
  • Lisensi versi terbaru disimpan di file application/config/we_cekid.json.

Panduan Pemasangan

Silakan melakukan pembelian modul melalui Telegram/Whatsapp Wekios:

Langkah 1: Download Modul

Download file modul dari link yang diberikan oleh Wekios setelah pembelian.

Jika link download belum tersedia atau sudah expired, silakan hubungi Telegram Wekios untuk meminta ulang file modul terbaru.

Langkah 2: Upload dan Extract

Upload file modul ke folder public_html, lalu extract file tersebut.

Pastikan struktur file masuk ke folder yang benar, seperti:

  • application/controllers/Myfolder.php
  • application/controllers/admin/Mod_cekid.php
  • application/views/myfolder/
  • application/views/admin/mod_cekid/
  • assets/mod_cekid/

Langkah 3: Pastikan Folder Upload Bisa Ditulis

Pastikan folder berikut memiliki permission yang benar agar upload gambar/logo/gif dari admin bisa berjalan: 

assets/mod_cekid

Jika upload gambar gagal, biasanya folder tersebut belum writable. Silakan ubah permission folder menjadi 755 atau 775 sesuai konfigurasi server.

Langkah 4: Buka Halaman Install

Setelah file berhasil diupload dan diextract, buka halaman berikut:

https://domain.com/admin/mod_cekid/install

Ganti domain.com dengan domain website kamu.

Langkah 5: Masukkan Lisensi

Pada versi terbaru, lisensi tidak lagi dipasang manual di file model.

Jika lisensi belum diisi atau salah, halaman admin Cek ID akan otomatis menampilkan form input lisensi.

Masukkan lisensi yang diberikan oleh Wekios, lalu simpan. Jika lisensi benar, sistem akan otomatis mengaktifkan modul: 

cekid_modul_v1.3

Lisensi akan disimpan ke file: 

application/config/we_cekid.json

Jadi file model lisensi lama seperti We_cekid_model.php / Cekid_model.php sudah tidak digunakan lagi.

Langkah 6: Pengaturan Global Modul

Setelah lisensi benar, buka halaman:

https://domain.com/admin/mod_cekid

Di halaman ini kamu bisa mengatur:

  • Warna utama halaman.
  • API key cek nama.
  • URL domain API.
  • Loading image/gif.
  • Status API.
  • Timeout API.
  • Cache hasil cek nama.
  • TTL cache.
  • Polling cek status TRX.
  • Wajib akses hanya dari aplikasi / WebView.
  • Tampilkan tombol kontak.
  • Tampilkan tombol kontak favorit.
  • Tampilkan tombol scan barcode di halaman Token Listrik.

Request cek nama dari halaman user tetap aman karena API key tidak ditampilkan di browser. Halaman user hanya mengirim request ke backend: 

myfolder/cek_nama

Langkah 7: Set Cek ID Per Produk

Buka halaman:

https://domain.com/admin/mod_cekid/set_cekid

Di halaman ini, pengaturan sudah dibuat per tab agar lebih mudah dipahami.

Untuk setiap produk, kamu bisa mengatur:

  • Judul halaman.
  • URL halaman.
  • Informasi / petunjuk halaman.
  • Logo/gambar halaman.
  • Produk dan operator yang ditampilkan.
  • Urutan operator yang tampil di halaman user.
  • Metode cek nama: Nonaktif, API, atau TRX.
  • URL API cek nama jika memakai mode API.
  • VO ID cek nama jika memakai mode TRX.
  • Timeout dan polling khusus jika diperlukan.

Untuk mode TRX, kamu cukup pilih VO ID TRX Cek Nama. Sistem akan otomatis membaca OP ID dan produk dari tabel voucher.

Langkah 8: Setting Bebas Nominal

Pada tab Bebas Nominal, kamu bisa mengatur operator/e-wallet yang ingin ditampilkan.

Setiap operator/e-wallet bisa diatur:

  • Nama tampil, contoh: Dana, OVO, GoPay, ShopeePay.
  • Kode API, contoh: dana, ovo, gopay.
  • OP ID produk, bisa satu atau banyak dipisahkan koma.
  • Mode cek nama per operator: Nonaktif, API, atau TRX.
  • URL API cek nama khusus operator.
  • VO ID TRX cek nama khusus operator.

Jika OP ID produk diisi lebih dari satu, contoh: 

629,630,975

Maka setelah cek nama berhasil, halaman user akan menampilkan pilihan produk sesuai OP ID yang diisi.

Minimal dan maksimal nominal Bebas Nominal juga bisa diatur langsung dari admin panel.

Langkah 9: Setting Custom View

Custom View sekarang bisa ditambah dari admin panel.

Kamu bisa menentukan jumlah custom view yang aktif, lalu mengatur masing-masing view seperti:

  • Judul halaman.
  • URL gambar/logo.
  • Produk/operator yang ditampilkan.
  • Informasi halaman.
  • Metode cek nama API/TRX jika diperlukan.

Contoh URL custom view:

  • https://domain.com/myfolder/views/1
  • https://domain.com/myfolder/views/2
  • https://domain.com/myfolder/views/3
  • https://domain.com/myfolder/views/4

Langkah 10: Cek Tabel dan Kolom Database

Saat install awal, modul akan memastikan data dan tabel berikut tersedia:

  • setelan.set_key = mod_cekid_data
  • setelan.set_key = mod_cekid_list
  • cek_id.ck_id
  • cek_id.ck_nomor
  • cek_id.ck_type
  • cek_id.ck_hasil
  • cek_id.ck_tanggal

Jika tabel cek_id sudah ada dari versi lama, installer hanya akan menambahkan kolom atau index yang belum ada. Data lama tidak akan dihapus.

Jika kamu ingin menambahkan manual kolom ck_type, gunakan SQL berikut: 

ALTER TABLE `cek_id` ADD `ck_type` VARCHAR(80) NULL AFTER `ck_nomor`;

Contoh URL API Default

Untuk PLN prabayar, URL API default versi terbaru adalah: 

urlDomain + "/v2/bill/pln/?id=" + idPlgn + "&key=" + apiKey

Untuk e-wallet, contoh URL API default: 

urlDomain + "/v2/ewallet/?code=" + selectedEWallet + "&hp=" + nomorhp + "&key=" + apiKey

Jika memakai mode TRX, URL API boleh dikosongkan dan cukup pilih VO ID khusus cek nama.

Link Akses di Aplikasi

Gunakan link berikut untuk mengakses modul dari aplikasi:

Untuk custom view lain, tinggal sesuaikan nomor view-nya: 

https://domain.com/myfolder/views/nomor_view

Catatan Penting

  • Jangan edit file model untuk lisensi, karena lisensi versi terbaru disimpan di application/config/we_cekid.json.
  • Pastikan folder assets/mod_cekid writable agar upload gambar/gif berhasil.
  • Jika halaman user tidak berubah setelah update, clear cache browser atau WebView terlebih dahulu.
  • Jika mode cek nama API tidak berjalan, pastikan API key dan URL domain sudah benar.
  • Jika mode cek nama TRX tidak berjalan, pastikan VO ID yang dipilih benar dan produk cek nama bisa membuat transaksi.
  • Jika ingin halaman hanya bisa dibuka dari aplikasi, aktifkan setting Hanya boleh diakses di Aplikasi dari admin panel.

Selamat menggunakan Modul Cek ID V1.3.