# Sambungkan Fluent Forms kepada Bayarcash

> Install Bayarcash for Fluent Forms untuk terima bayaran FPX, DuitNow, kad dan saluran cross-border pada payment form Fluent Forms Pro anda.
>
> Source: https://docs.bayarcash.com/ms/fluent-forms/

**Bayarcash for Fluent Forms** menambah Bayarcash sebagai kaedah bayaran pada payment form Fluent Forms Pro anda. Pelanggan anda mengisi form, membayar di page Bayarcash, kemudian kembali ke laman web anda.

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

## Saluran yang disokong

Plugin ini menambah satu kaedah bayaran bagi setiap saluran. Anda pilih kaedah yang anda mahu pada setiap form:

| Kaedah bayaran | Cara pelanggan anda membayar |
|---|---|
| FPX Online Banking | Perbankan online FPX |
| Credit Card | Akaun kad kredit melalui FPX |
| DuitNow Online Banking | DuitNow Online Banking/Wallets |
| DuitNow QR | Mana-mana aplikasi bank atau e-wallet yang menyokong DuitNow QR |
| SPayLater | SPayLater by Shopee |
| Boost PayFlex | Boost PayFlex |
| Indonesia Online Banking | Perbankan online Indonesia (QRIS) |
| Indonesia e-Wallet | E-wallet Indonesia (QRIS) |
| NETS Singapore | NETS (Singapura) |

Plugin ini hanya menerima bayaran sekali sahaja, dalam MYR. Plugin ini tidak menyokong langganan dan 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

Anda memerlukan perkara ini sebelum anda sediakan 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/).
- Fluent Forms Pro yang sudah di-install dan aktif. Mata wang bayaran mesti ringgit Malaysia (MYR).

## Install plugin

Plugin ini percuma di WordPress.org dengan nama [Bayarcash for Fluent Forms](https://wordpress.org/plugins/bayarcash-for-fluent-forms/). Untuk install plugin ini:

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

## Masukkan keys anda

Anda hanya perlu masukkan keys sekali untuk semua form anda:

1. Pergi ke **Fluent Forms** → **Bayarcash Settings**. Tab **Global Configuration** dibuka.
   
2. Untuk bayaran sebenar, biarkan **Enable Sandbox Mode** off.
3. Paste token anda ke dalam **Personal Access Token** dan klik **Verify Token**. Plugin memaparkan "Token verified successfully" apabila token itu berfungsi.
4. Pilih portal anda dalam **Portal Key**.
5. Paste key anda ke dalam **API Secret Key**.
6. Pilihan: di bawah **Miscellaneous**, tukar **Payment Title**. Tajuk default ialah **Bayarcash**.
7. Simpan tetapan anda.

## Tambah Bayarcash pada form

Selepas keys anda disimpan, on-kan kaedah bayaran pada setiap form:

1. Buka form itu dalam Fluent Forms dan pergi ke tetapan bayarannya.
2. On-kan kaedah bayaran Bayarcash yang anda mahu, contohnya **FPX Online Banking** dan **DuitNow QR**.
3. Pilihan: tukar **Method Label** bagi setiap kaedah. Label default ialah "Pay with" diikuti nama kaedah itu.
4. Simpan form itu.

## Guna keys lain pada satu form

Sesuatu form boleh menggunakan akaun atau portal Bayarcash sendiri, dan bukan tetapan global:

1. Dalam **Fluent Forms** → **Bayarcash Settings**, buka **Form Configuration** dan pilih form itu.
2. On-kan **Customization**.
3. Masukkan **Personal Access Token**, **Portal Key** dan **API Secret Key** untuk form ini. Di sini **Portal Key** ialah kotak teks, jadi paste key itu dari merchant dashboard.
4. Simpan tetapan anda.

## Tambah caj pemprosesan

Tab **Bayarcash Gateway Fee** membolehkan anda menambah caj pada amaun yang pelanggan bayar. Anda boleh tetapkan caj untuk **FPX Online Banking**, **Credit Card**, **DuitNow Online Banking** dan **DuitNow QR**. Caj itu boleh jadi amaun tetap, peratusan atau kedua-duanya, dengan keterangan yang pelanggan nampak. Saluran lain menggunakan caj **DuitNow QR**. Caj ini digunakan untuk semua form.

## Uji dalam sandbox

Uji dalam sandbox Bayarcash sebelum anda terima bayaran sebenar:

1. Dapatkan token, secret key dan portal key dari [merchant dashboard sandbox](https://console.bayarcash-sandbox.com). Keys live tidak berfungsi dalam sandbox.
2. On-kan **Enable Sandbox Mode**. Page itu memaparkan "Sandbox mode is enabled. Make sure to use sandbox credentials for testing."
3. Masukkan keys sandbox, sahkan token itu dan simpan.
4. Hantar satu test payment pada form anda.
5. Apabila semuanya berfungsi, off-kan **Enable Sandbox Mode**, masukkan keys live anda dan simpan semula.

Jika **Customization** di-on-kan pada sesuatu form, form itu ada suis **Enable Sandbox Mode** sendiri. Semak suis itu juga.

## Cara keputusan bayaran sampai ke laman web anda

Anda tidak perlu paste URL callback ke dalam merchant dashboard. Plugin ini menghantar alamat sendiri bersama setiap bayaran, iaitu `/index.php?fluentform_payment_api_notify=1` pada laman web anda, dan Bayarcash menghantar keputusan ke alamat itu. Kemudian plugin menandakan submission itu sebagai paid atau failed.

Jika submission kekal pending selepas bayaran berjaya, pastikan laman web anda terbuka kepada 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 Fluent Forms:

- **Letak ruangan nama dan e-mel pada setiap payment form.** Bayarcash memerlukan nama dan e-mel pelanggan anda untuk membuat bayaran itu.
- **Guna Backup and Restore sebelum perubahan besar.** Tab **Backup and Restore** export tetapan Bayarcash anda, supaya anda boleh pulihkan tetapan itu kemudian.

## Isu biasa

### Form saya memaparkan "Error! Currency not supported. The only supported currency is MYR". Bagaimana saya boleh betulkan?

Bayarcash hanya menerima bayaran dalam MYR. Tetapkan mata wang kepada ringgit Malaysia dalam tetapan bayaran Fluent Forms. Selagi anda belum menukarnya, page tetapan Bayarcash memaparkan notis merah tentang mata wang yang tidak serasi.

### Kenapa form saya memaparkan "Error: Bayarcash does not support subscriptions right now."?

Bayarcash for Fluent Forms hanya menerima bayaran sekali sahaja. Buang item langganan dari form itu, atau guna kaedah bayaran lain untuk item itu.

### Kenapa senarai Portal Key kosong atau memaparkan "Please verify Personal Access Token first"?

Senarai ini hanya diisi selepas token disahkan. Paste token anda ke dalam Personal Access Token dan klik Verify Token. Jika plugin memaparkan "Verification failed", pastikan token itu sepadan dengan tetapan Enable Sandbox Mode. Guna token sandbox untuk sandbox, dan token live untuk live.

### Kenapa saya nampak "Bayarcash for Fluent Forms requires Fluent Forms Pro to be installed and activated."?

Plugin ini memerlukan Fluent Forms Pro. Fluent Forms versi percuma sahaja tidak cukup. Install dan aktifkan Fluent Forms Pro, kemudian muat semula page itu.