# Terima bayaran Bayarcash dalam WHMCS

> Install modul gateway Bayarcash dalam WHMCS, masukkan keys anda, sediakan cron job dan tambah caj gateway pada invois jika perlu.
>
> Source: https://docs.bayarcash.com/ms/whmcs/

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](/ms/api-keys/) dan [Portal](/ms/portals/).
- Akses admin ke WHMCS, dan akses ke fail server atau tetapan cron.

## Install modul

Muat turun modul dari [WHMCS Marketplace](https://marketplace.whmcs.com/product/7531-bayarcash). Kemudian:

1. Unzip fail itu. Pastikan fail itu ada folder **modules**, dengan folder **addons** dan **gateways** di dalamnya.
2. Upload folder **modules** ke folder WHMCS anda, supaya fail-fail itu bergabung dengan fail yang sedia ada.
3. Dalam admin area WHMCS, pergi ke **System Settings** → **Payment Gateways**.
4. 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](/ms/payment-channels/).

## 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:

1. Pergi ke **System Settings** → **Addon Modules**.
2. Cari **Bayarcash Gateway Fees** dan klik **Activate**, kemudian **Configure**.
3. Di bawah **Access Control**, tandakan **Full Administrator** dan simpan.
4. Buka **Addons** → **Bayarcash Gateway Fees**.
5. 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 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.