Sambungkan FluentCart kepada Bayarcash

Dikemas kini 30 September 2026

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.

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.

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

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

Sediakan Bayarcash

Semua tetapan ada pada satu page:

Pergi ke FluentCart → Settings → Payments dan buka Bayarcash.
Paste token anda ke dalam Personal Access Token (PAT).
Paste secret key anda ke dalam API Secret Key.
Paste portal key anda ke dalam Portal Key.
Dalam Payment Channels, tandakan saluran yang pelanggan anda boleh pilih. FPX (Online Banking) dan DuitNow QR sudah ditandakan secara default.
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.

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

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.

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.

Adakah artikel ini membantu?