# Terima bayaran Bayarcash dalam OpenCart

> Install modul Bayarcash dalam OpenCart 3 atau 4, masukkan keys anda, pilih saluran bayaran dan buat ujian sebelum go live.
>
> Source: https://docs.bayarcash.com/ms/opencart/

Dengan modul Bayarcash, kedai OpenCart anda boleh menerima bayaran melalui Bayarcash. Modul ini ada dua fail zip: satu untuk OpenCart 3 dan satu lagi untuk OpenCart 4. Guna fail yang sepadan dengan versi kedai anda.

Untuk melihat modul ini berfungsi sebelum anda install, cuba [demo langsung](https://opencart.bayarcash-demo.com/).

## Sebelum anda mula

Anda memerlukan perkara berikut:

- Akaun merchant Bayarcash yang sudah diluluskan, dengan saluran bayaran anda sudah di-on-kan.
- **Personal Access Token**, **API Secret** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/) dan [Portal](/ms/portals/).
- Ringgit Malaysia (MYR) sebagai salah satu mata wang dalam kedai anda.

## Install modul

Muat turun fail zip modul dari [page plugin Bayarcash](https://plugin.bayarcash.com/). Kemudian:

1. Dalam admin OpenCart, pergi ke **Extensions** → **Installer** dan upload fail zip itu.
2. Pergi ke **Extensions** → **Extensions** dan pilih jenis **Payments**.
3. Cari **Bayarcash** dalam senarai. Klik **Install**, kemudian **Edit**.

## Masukkan keys anda

Tetapan dibuka pada tab **API details**. Untuk mengisinya:

1. Kekalkan atau tukar **Payment Name**. Pelanggan nampak nama ini semasa checkout.
2. Paste **Personal Access Token**, **API Secret** dan **Portal Key** anda.
3. Biarkan **Sandbox Mode** off untuk bayaran sebenar. On-kan hanya dengan keys sandbox.
4. Simpan. OpenCart menyemak token anda semasa anda simpan.

## Pilih saluran & aktifkan modul

Seterusnya, buka tab **General**:

1. Di bawah **Payment Channels**, pilih saluran yang anda mahu tawarkan. Tekan Ctrl atau Cmd untuk memilih beberapa saluran.
2. Tetapkan **Status** kepada on.
3. Simpan.

Semasa checkout, pelanggan nampak setiap saluran dengan nama mengikut **Payment Name** anda, contohnya "Bayarcash - Credit Card".

## Tetapan lain

Tab-tab ini pilihan:

| Tab | Fungsinya |
|---|---|
| **Order status** | Menetapkan status untuk **Canceled Order Status**, **Failed Order Status** dan **Paid Order Status**. |
| **Customize checkout** | **Instruction** memaparkan teks anda sendiri sebelum pelanggan membayar. |
| **Troubleshoot** | **Debug logging** menulis butiran ke log ralat OpenCart. |

## Tips

Dua habit ini membantu anda dengan OpenCart:

- **Uji sebelum anda go live.** On-kan **Sandbox Mode** dengan keys sandbox dan buat satu pesanan. Kemudian, off-kan suis itu dan guna keys live anda.
- **Semak Sandbox Mode dahulu jika bayaran live gagal.** Sandbox Mode mesti off untuk bayaran sebenar.

## Isu biasa

### Kenapa checkout memaparkan 'Bayarcash requires MYR currency to be set-up.'?

Tambah ringgit Malaysia (MYR) sebagai mata wang dalam kedai anda. Bayarcash hanya memproses MYR. Mata wang lain hanya berfungsi jika Convert To Processing di-on-kan.

### Kenapa saya tidak dapat menyimpan tetapan kerana ada ruangan yang kosong?

Personal Access Token, API Secret, Portal Key dan Payment Name wajib diisi. Jika anda on-kan Instruction, Bayarcash Instructions juga wajib diisi.

### Kenapa saya nampak teks error_invalid_token atau error_pat_required semasa menyimpan tetapan?

Ini mesej ralat yang belum siap. Maksudnya, Personal Access Token kosong, atau Bayarcash tidak menerima token itu. Copy token itu sekali lagi dari merchant dashboard anda dan simpan.

### Kenapa pelanggan nampak 'Invalid redirect.' atau 'Payment method is incorrect!' semasa checkout?

Minta pelanggan kembali ke checkout dan pilih kaedah bayaran Bayarcash sekali lagi. Jika masalah ini berulang, on-kan Debug logging pada tab Troubleshoot dan kongsi log ralat OpenCart dengan team Bayarcash.