# Terima bayaran Bayarcash dalam HostBill

> Install modul bayaran Bayarcash dalam HostBill dan masukkan portal key, token dan API secret key anda.
>
> Source: https://docs.bayarcash.com/ms/hostbill/

Dengan modul Bayarcash untuk HostBill, pelanggan anda boleh membayar invois melalui Bayarcash. Modul ini hanya menerima MYR.

## Sebelum anda mula

Anda memerlukan perkara berikut:

- Akaun merchant Bayarcash yang sudah diluluskan.
- Fail modul Bayarcash untuk HostBill, daripada Bayarcash.
- **Portal Key**, **Personal Access Token** dan **API Secret Key** anda. Lihat [Cari API keys anda](/ms/api-keys/) dan [Portal](/ms/portals/).
- Akses ke fail server HostBill anda. Composer mesti ada pada server itu.

## Install modul

Biasanya developer atau host anda yang membuat bahagian ini. Langkah-langkahnya:

1. Copy folder modul ke dalam folder HostBill anda, di bawah folder **includes/modules/Payment**.
2. Dalam folder modul itu, jalankan `composer install` untuk menambah library yang modul itu perlukan.
3. Dalam admin area HostBill, aktifkan **Bayarcash** dalam senarai modul bayaran.

## Masukkan keys anda

Buka tetapan modul Bayarcash dan isi ruangan ini:

| Ruangan | Apa yang perlu dimasukkan |
|---|---|
| **Portal Key** | Portal yang akan menerima bayaran. |
| **Token** | Personal Access Token anda. |
| **API Secret Key** | Secret key anda. Jangan kongsi key ini. |
| **Use sandbox** | Tandakan hanya semasa ujian dengan keys sandbox. |

Simpan tetapan itu. Di page bayaran, pelanggan anda boleh pilih **FPX**, **FPX Line of Credit** atau **DuitNow DOBW**.

## Tips

Dua habit ini membantu anda dengan HostBill:

- **Uji dalam sandbox dahulu.** Bayar satu invois ujian dengan keys sandbox. Kemudian, buang tanda pada **Use sandbox** dan tukar kepada keys live.
- **Uji modul ini dalam versi HostBill anda sendiri.** Bayarcash tidak menyatakan versi minimum HostBill. Jadi, uji satu bayaran sebelum anda go live.

## Isu biasa

### Kenapa pelanggan saya nampak 'Payment failed, please contact administrator'?

Semak Portal Key, Token dan API Secret Key dalam tetapan modul. Pastikan juga invois anda dalam MYR. Bayarcash hanya menerima MYR.

### Kenapa saya nampak 'Payment callback response verification failed' walaupun bayaran berjaya?

API Secret Key dalam HostBill tidak sama dengan key dalam merchant dashboard anda. Copy key itu sekali lagi dan simpan.