Plugin WHMCS

Pendahuluan

Apa itu WHMCS?

WHMCS (Web Host Manager Complete Solution) adalah platform otomatisasi bisnis hosting yang banyak digunakan oleh:

Hosting Provider
Domain Registrar
Web Agency
IT Professional
Developer

Fungsi Utama WHMCS

Billing Management
Payment Management
Order Management
Customer Support
Reporting
Domain Registration
Hosting Provisioning
Fraud Protection
Customer Account Management

Selain hosting, WHMCS juga dapat digunakan untuk produk lain seperti VPS, VPN, Email Hosting, Game Server, Domain Service, dan produk digital lainnya.

Persyaratan

Persyaratan Sebelum Instalasi

Sebelum memulai, pastikan:

WHMCS sudah terinstall
Memiliki akun iPaymu
Sudah mendapatkan API Key dan VA Number
Memiliki akses FTP atau SSH ke server

Step 1: Download Plugin

Download plugin WHMCS dari halaman Plugin iPaymu.

Download Plugin WHMCS

Step 2: Instalasi Manual Plugin

Struktur File

Setelah plugin diekstrak, akan terdapat file dan folder berikut:

callback/
ipaymu/
ipaymu.php

Langkah Instalasi

Copy seluruh isi folder callback/ ke direktori:

/modules/gateways/callback/

Copy file dan folder berikut:

ipaymu/
ipaymu.php

ke direktori:

/modules/gateways/

Step 3: Aktivasi Module di WHMCS

Masuk ke Settings → Apps & Integrations.

Settings Apps & Integrations

Pilih Browse → Payments.

Browse Payments

Cari iPaymu Direct Payment, lalu klik Activate.

Aktivasi iPaymu Direct Payment

Setelah aktif, akan muncul status Active. Klik Manage.

Status Module Aktif

Step 4: Konfigurasi iPaymu

Masukkan konfigurasi berikut:

Field	Nilai
Environment	`Sandbox` atau `Production`
VA Number	VA Number akun iPaymu Anda
API Key	API Key akun iPaymu Anda

Klik Save Changes.

Pengaturan Environment iPaymu

Mode Sandbox

Gunakan mode Sandbox untuk melakukan testing terlebih dahulu sebelum beralih ke mode Production.

Step 5: Konfigurasi Produk

Atur Nama Produk, Deskripsi, dan Tampilan Produk.

Pengaturan Produk

Buat Product Group, kemudian tambahkan Product.

Product Group dan Product

Atur Pricing Produk sesuai kebutuhan, misalnya:
- Monthly
- Quarterly
- Semi Annually
- Annually

Pricing Produk

Step 6: Simulasi Pembelian

Customer memilih produk, lalu klik Order Now.

Order Now

Customer melakukan Checkout.

Halaman Checkout

Pada bagian Payment Details, pilih iPaymu Direct Payment, lalu klik Complete Order.

Pemilihan Metode Pembayaran

Step 7: Pembayaran Invoice

Invoice berhasil dibuat dan muncul tombol Bayar.

Invoice dengan Tombol Bayar

Customer diarahkan ke halaman pembayaran iPaymu.

Halaman Pembayaran iPaymu

Step 8: Status Pembayaran

Setelah pembayaran sukses, invoice menampilkan status berhasil.

Invoice Berhasil

Status invoice berubah menjadi PAID.

Status Invoice PAID

Penanganan Error

Jika nominal invoice tidak memenuhi syarat atau terdapat kesalahan konfigurasi, sistem akan menampilkan pesan error.

Contoh Pesan Error

Tips Troubleshooting

Pastikan API Key dan VA Number sudah benar.
Pastikan Environment sesuai (Sandbox untuk testing, Production untuk live).
Periksa callback URL sudah dapat diakses oleh server iPaymu.