Sambungkan Fluent Forms kepada Bayarcash

Dikemas kini 30 September 2026

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.

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.

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.
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. Untuk install plugin ini:

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

Masukkan keys anda

Anda hanya perlu masukkan keys sekali untuk semua form anda:

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

Tambah Bayarcash pada form

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

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

Guna keys lain pada satu form

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

Dalam Fluent Forms → Bayarcash Settings, buka Form Configuration dan pilih form itu.
On-kan Customization.
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.
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:

Dapatkan token, secret key dan portal key dari merchant dashboard sandbox. Keys live tidak berfungsi dalam sandbox.
On-kan Enable Sandbox Mode. Page itu memaparkan “Sandbox mode is enabled. Make sure to use sandbox credentials for testing.”
Masukkan keys sandbox, sahkan token itu dan simpan.
Hantar satu test payment pada form anda.
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.

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-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.

Adakah artikel ini membantu?