Terima bayaran Bayarcash dalam WHMCS

Q: Kenapa pelanggan nampak 'An error occurred. Please try again later.' selepas memilih saluran?

Semak keys anda dalam tetapan gateway Bayarcash. On-kan Sandbox Mode hanya apabila anda menggunakan keys sandbox.

Dengan modul Bayarcash untuk WHMCS, pelanggan anda boleh membayar invois melalui Bayarcash. Modul ini hanya menerima invois dalam MYR. Panduan ini menerangkan gateway, cron job dan add-on caj yang pilihan.

Sebelum anda mula

Anda memerlukan perkara berikut:

Akaun merchant Bayarcash yang sudah diluluskan, dengan saluran bayaran yang anda mahu sudah di-on-kan.
Personal Access Token (PAT), Portal Key dan API Secret Key anda. Lihat Cari API keys anda dan Portal.
Akses admin ke WHMCS, dan akses ke fail server atau tetapan cron.

Install modul

Muat turun modul dari WHMCS Marketplace. Kemudian:

Unzip fail itu. Pastikan fail itu ada folder modules, dengan folder addons dan gateways di dalamnya.
Upload folder modules ke folder WHMCS anda, supaya fail-fail itu bergabung dengan fail yang sedia ada.
Dalam admin area WHMCS, pergi ke System Settings → Payment Gateways.
Buka tab All Payment Gateways, cari Bayarcash dan aktifkan.

Masukkan keys & pilih saluran

Dalam tetapan Bayarcash, isi ruangan ini:

Ruangan	Apa yang perlu dimasukkan
Personal Access Token (PAT)	Token Bayarcash anda.
Portal Key	Portal yang akan menerima bayaran.
API Secret Key	Secret key anda. Jangan kongsi key ini.
Sandbox Mode	On-kan hanya untuk ujian, dengan keys sandbox.
Payment Information	Teks yang dipaparkan pada page invois.
Successful Payment dan Unsuccessful Payment	Page yang pelanggan nampak selepas bayaran berjaya atau gagal: Specific Invoice, List Invoice atau Client Area.
Payment Channels	Nombor saluran yang anda tawarkan, dipisahkan dengan koma.

Klik Save Changes apabila selesai. Nombor saluran ialah:

Nombor	Saluran
1	FPX Online Banking
4	FPX Line of Credit (Credit Card Account)
5	DuitNow Online Banking/Wallets
6	DuitNow QR
7	SPayLater
8	Boost PayFlex
9	QRIS Indonesia Online Banking
10	QRIS Indonesia eWallet
11	NETS Singapore

Sesuatu saluran mesti di-on-kan dalam akaun Bayarcash anda sebelum pelanggan boleh menggunakannya. Lihat Saluran bayaran.

Sediakan cron job

Bayarcash memerlukan cron job yang menyemak bayaran pending setiap minit. Minta host anda menambah cron job ini. Tukar whmcsdomain kepada domain WHMCS anda:

* * * * * wget -q -O /dev/null 'https://whmcsdomain/modules/gateways/bayarcash/bayarcash_cron.php?job=requery'

Tambah caj gateway pada invois (pilihan)

Guna add-on Bayarcash Gateway Fees jika anda mahu pelanggan menanggung caj bayaran. Add-on ini menambah baris caj pada invois, mengikut saluran yang pelanggan pilih. Untuk menyediakannya:

Pergi ke System Settings → Addon Modules.
Cari Bayarcash Gateway Fees dan klik Activate, kemudian Configure.
Di bawah Access Control, tandakan Full Administrator dan simpan.
Buka Addons → Bayarcash Gateway Fees.
Untuk setiap saluran, tetapkan Flat Price (RM) dan Percentage Fee (%), kemudian klik Save All Settings.

Add-on ini bermula dengan nilai contoh. Jadi, semak amaun itu dengan perjanjian Bayarcash anda sebelum anda simpan.

Tips

Dua habit ini membantu anda dengan WHMCS:

Uji dengan Sandbox Mode dahulu. Guna keys sandbox dan bayar satu invois ujian. Kemudian, tukar kepada keys live dan off-kan Sandbox Mode.
Pastikan cron job sentiasa berjalan. Jika cron job berhenti, pelanggan mungkin sudah membayar, tetapi invois mereka kekal belum dibayar sehingga anda menyemaknya.

Isu-isu biasa

Kenapa pelanggan saya nampak mesej bahawa Bayarcash hanya menerima bayaran dalam MYR?

Invois itu dalam mata wang lain. Bayarcash hanya menerima MYR, jadi keluarkan invois dalam ringgit Malaysia.

Kenapa invois masih belum dibayar walaupun pelanggan sudah membayar?

Pastikan cron job requery berjalan setiap minit, dan Personal Access Token, Portal Key dan API Secret Key anda betul. Cron job itu yang mengemas kini bayaran yang masih pending.

Kenapa pelanggan nampak 'An error occurred. Please try again later.' selepas memilih saluran?

Semak keys anda dalam tetapan gateway Bayarcash. On-kan Sandbox Mode hanya apabila anda menggunakan keys sandbox.

Adakah artikel ini membantu?