# Sambungkan FluentCart kepada Bayarcash

> Install Bayarcash for FluentCart, masukkan keys anda dan pilih saluran bayaran Bayarcash yang pelanggan nampak semasa checkout.
>
> Source: https://docs.bayarcash.com/ms/fluentcart/

**Bayarcash for FluentCart** menambah Bayarcash pada checkout FluentCart anda. Pelanggan anda memilih saluran bayaran, membuat bayaran di page Bayarcash, dan kemudian kembali ke page resit anda.

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

## Saluran yang disokong

Anda pilih saluran yang pelanggan nampak semasa checkout. Pilihan dalam **Payment Channels** ialah:

| Saluran | Pelanggan anda membayar dengan |
|---|---|
| **FPX (Online Banking)** | Online banking FPX |
| **FPX Line of Credit** | Akaun kad kredit melalui FPX |
| **DuitNow Online Banking/Wallets** | Online banking atau e-wallet DuitNow |
| **DuitNow QR** | Mana-mana aplikasi perbankan atau e-wallet yang menyokong DuitNow QR |
| **Credit Card** | Visa atau Mastercard |
| **Boost PayFlex** | Boost PayFlex |
| **QRIS (Online Banking)** | Online banking Indonesia |
| **QRIS (E-Wallet)** | E-wallet Indonesia |
| **NETS** | NETS (Singapura) |
| **Alipay** | Alipay |
| **WeChat Pay** | WeChat Pay |
| **PromptPay** | PromptPay (Thailand) |

Senarai itu juga memaparkan **FPX Direct Debit**. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/).

## Sebelum anda mula

Sediakan perkara ini sebelum anda menyediakan plugin:

- Akaun merchant Bayarcash yang sudah diluluskan.
- **Personal Access Token (PAT)**, **API Secret Key** dan **Portal Key** anda. Lihat [Cari API keys anda](/ms/api-keys/).
- FluentCart yang sudah di-install dan aktif, dengan mata wang kedai ringgit Malaysia (MYR).

## Install plugin

Plugin ini percuma di WordPress.org sebagai [Bayarcash for FluentCart](https://wordpress.org/plugins/bayarcash-for-fluentcart/). Untuk install plugin ini:

1. Dalam WordPress, pergi ke **Plugins** → **Add New**.
2. Cari **Bayarcash for FluentCart** dan klik **Install**.
3. Klik **Activate**.

## Sediakan Bayarcash

Semua tetapan ada pada satu page:

1. Pergi ke **FluentCart** → **Settings** → **Payments** dan buka **Bayarcash**.
   
2. Paste token anda ke dalam **Personal Access Token (PAT)**.
3. Paste secret key anda ke dalam **API Secret Key**.
4. Paste portal key anda ke dalam **Portal Key**.
5. Dalam **Payment Channels**, tandakan saluran yang pelanggan anda boleh pilih. **FPX (Online Banking)** dan **DuitNow QR** sudah ditandakan secara default.
6. On-kan Bayarcash dan simpan.

Apabila kedai anda dalam live mode, FluentCart memaparkan "Bayarcash gateway credentials verified successfully!" selepas anda simpan. Mesej ini hanya mengesahkan bahawa semua ruangan sudah diisi. Jadi, buat satu bayaran kecil untuk memastikan keys anda berfungsi.

## Tukar rupa checkout

Page yang sama juga menetapkan rupa butang Bayarcash semasa checkout:

| Tetapan | Apa yang berubah |
|---|---|
| **Bayarcash Checkout Theme** | **Light** atau **Dark** |
| **Bayarcash Checkout Button Text** | Teks butang. Secara default, teksnya ialah "Pay with Bayarcash". |
| **Bayarcash Checkout Button Color** dan **Bayarcash Checkout Button Hover Color** | Warna butang |
| **Bayarcash Checkout Button Text Color** | Warna teks butang |
| **Bayarcash Checkout Button Font Size** | Saiz teks, contohnya `16px` |

## Uji dalam sandbox

Plugin ini tiada suis sandbox sendiri. Plugin ini mengikut mod kedai FluentCart anda:

- **Test mode:** bayaran dihantar ke sandbox Bayarcash dengan test keys yang sudah ada dalam plugin. Keys yang anda masukkan tidak digunakan, dan FluentCart memaparkan "Bayarcash test mode is enabled with your credentials." semasa anda simpan.
- **Live mode:** bayaran dihantar ke Bayarcash dengan keys yang anda masukkan.

Tukar kedai anda kepada test mode, buat satu pesanan dan bayar di page sandbox. Apabila semuanya berfungsi, tukar kedai anda semula kepada live mode. Kemudian, buat satu bayaran sebenar yang kecil untuk menyemak keys anda sendiri.

## Cara Bayarcash menghantar keputusan bayaran ke kedai anda

Anda tidak perlu paste callback URL ke dalam merchant dashboard. Plugin ini menghantar alamatnya sendiri bersama setiap bayaran. Bayarcash melaporkan keputusan bayaran ke laman web anda di `/?fluent-cart=fct_payment_listener_ipn&method=bayarcash`, dan pelanggan anda kembali ke page resit FluentCart anda. Kemudian, plugin ini menandakan pesanan itu sebagai sudah dibayar atau gagal. Plugin ini tidak akan menukar pesanan yang sudah dibayar atau sudah di-refund.

Jika pesanan kekal pending walaupun bayaran berjaya, pastikan laman web anda boleh diakses oleh umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/).

## Tips

Dua habit ini membantu anda dengan FluentCart:

- **Tandakan hanya saluran yang portal anda boleh terima.** Pelanggan yang memilih saluran yang di-off-kan untuk portal anda tidak dapat membayar.
- **Sentiasa buat satu ujian dengan keys live anda.** Test mode menggunakan keys plugin itu sendiri, jadi ujian itu tidak membuktikan keys anda betul.

## Isu biasa

### Kenapa saya nampak "Portal Key is required to activate the gateway." semasa menyimpan tetapan?

FluentCart memerlukan ketiga-tiga keys sebelum mengaktifkan Bayarcash: Personal Access Token (PAT), API Secret Key dan Portal Key. Mesej yang sama dipaparkan untuk dua keys yang lain. Lihat Cari API keys anda (/ms/api-keys/).

### Kenapa checkout memaparkan "Bayarcash payment gateway is not properly configured"?

Kedai anda dalam live mode, tetapi salah satu daripada tiga keys itu tiada. Buka FluentCart → Settings → Payments, buka Bayarcash, isi setiap key dan simpan.

### Kenapa bayaran masih gagal walaupun FluentCart memaparkan "Bayarcash gateway credentials verified successfully!"?

Mesej itu hanya bermaksud ketiga-tiga ruangan sudah diisi. FluentCart tidak menyemak keys itu dengan Bayarcash. Copy setiap key sekali lagi dari merchant dashboard, dan pastikan portal anda boleh menerima saluran yang anda tandakan. Lihat Kenapa bayaran gagal (/ms/payment-failed/).

### Kenapa checkout memaparkan "Failed to create payment intent"?

Bayarcash menolak request bayaran itu. Biasanya puncanya ialah key yang salah, atau saluran yang belum di-on-kan untuk portal anda. Semak keys anda dan Payment Channels yang anda tandakan.