Connect FluentCart to Bayarcash

Updated 30 September 2026

Bayarcash for FluentCart adds Bayarcash to your FluentCart checkout. Your customer picks a payment channel, pays on the Bayarcash page and comes back to your receipt page.

To see the plugin at work before you install it, try the live demo.

What it supports

You choose which channels your customers see at checkout. The options in Payment Channels are:

Channel	What your customer pays with
FPX (Online Banking)	FPX online banking
FPX Line of Credit	A credit card account through FPX
DuitNow Online Banking/Wallets	DuitNow online banking or e-wallet
DuitNow QR	Any DuitNow QR banking or e-wallet app
Credit Card	Visa or Mastercard
Boost PayFlex	Boost PayFlex
QRIS (Online Banking)	Indonesian online banking
QRIS (E-Wallet)	Indonesian e-wallets
NETS	NETS (Singapore)
Alipay	Alipay
WeChat Pay	WeChat Pay
PromptPay	PromptPay (Thailand)

The list also shows FPX Direct Debit. A channel only works if it is also turned on for your Bayarcash portal. See Payment channels.

Before you start

You need these before you set up the plugin:

An approved Bayarcash merchant account.
Your Personal Access Token (PAT), API Secret Key and Portal Key. See Find your API keys.
FluentCart installed and active, with the store currency set to Malaysian ringgit (MYR).

Install the plugin

The plugin is free on WordPress.org as Bayarcash for FluentCart. To install it:

In WordPress, go to Plugins → Add New.
Search for Bayarcash for FluentCart and click Install.
Click Activate.

Set up Bayarcash

All the settings are on one page:

Go to FluentCart → Settings → Payments and open Bayarcash.
Paste your token into Personal Access Token (PAT).
Paste your key into API Secret Key.
Paste your portal key into Portal Key.
In Payment Channels, tick the channels your customers can choose. FPX (Online Banking) and DuitNow QR are ticked to start with.
Turn Bayarcash on and save.

When your store is live, saving shows “Bayarcash gateway credentials verified successfully!”. This only confirms the fields are filled in, so make a small test payment to be sure the keys work.

Change the checkout look

The same page sets how the Bayarcash button looks at checkout:

Setting	What it changes
Bayarcash Checkout Theme	Light or Dark
Bayarcash Checkout Button Text	The button text. It is “Pay with Bayarcash” by default.
Bayarcash Checkout Button Color and Bayarcash Checkout Button Hover Color	The button colours
Bayarcash Checkout Button Text Color	The colour of the button text
Bayarcash Checkout Button Font Size	The text size, for example `16px`

Test in sandbox

The plugin has no sandbox switch of its own. It follows your FluentCart store mode:

Test mode: payments go to the Bayarcash sandbox, using test keys built into the plugin. The keys you entered are not used, and saving shows “Bayarcash test mode is enabled with your credentials.”
Live mode: payments go to Bayarcash using the keys you entered.

Put your store in test mode, place an order and pay it on the sandbox page. When it works, put your store back in live mode and make one small real payment to check your own keys.

How payment results reach your store

You do not paste a callback URL into the merchant dashboard. The plugin sends its own addresses with each payment: Bayarcash reports the result to your site at /?fluent-cart=fct_payment_listener_ipn&method=bayarcash, and your customer returns to your FluentCart receipt page. The plugin then marks the order paid or failed. It never changes an order that is already paid or refunded.

If orders stay pending after a successful payment, make sure your site is public, uses HTTPS, and that no firewall or security plugin blocks that address. See Callbacks and checksum.

Tips

Two habits help with FluentCart:

Tick only the channels your portal can take. Customers who pick a channel that is off for your portal cannot pay.
Always test once with your live keys. Test mode uses the plugin’s own keys, so it does not prove your keys are right.

Common issues

Saving shows "Portal Key is required to activate the gateway."

FluentCart needs all three keys before it turns Bayarcash on: Personal Access Token (PAT), API Secret Key and Portal Key. The messages for the other two say the same. See Find your API keys.

Checkout shows "Bayarcash payment gateway is not properly configured".

Your store is in live mode but one of the three keys is missing. Open FluentCart → Settings → Payments, open Bayarcash, fill in every key and save.

Saving said "Bayarcash gateway credentials verified successfully!" but payments still fail. Why?

That message only means the three fields are filled in. It does not check the keys with Bayarcash. Copy each key again from the merchant dashboard, and make sure the portal can take the channels you ticked. See Why a payment failed.

Checkout shows "Failed to create payment intent".

Bayarcash refused the payment request, usually because of a wrong key or a channel that is not turned on for your portal. Check your keys and your ticked Payment Channels.

Was this article helpful?