Accept Bayarcash payments in WHMCS

The Bayarcash module for WHMCS lets your clients pay invoices through Bayarcash. It takes MYR invoices only. This guide covers the gateway, the cron job and the optional fees add-on.

Before you start

You need the following:

• An approved Bayarcash merchant account with the payment channels you want switched on.
• Your Personal Access Token (PAT), Portal Key and API Secret Key. See API keys and Portals.
• Admin access to WHMCS and to the server files or cron settings.

Install the module

Download the module from the WHMCS Marketplace. Then:

1. Unzip the file. Check that it has a modules folder with addons and gateways inside.
2. Upload the modules folder to your WHMCS installation folder, so the files merge with the existing ones.
3. In the WHMCS admin area, go to System Settings → Payment Gateways.
4. Open the All Payment Gateways tab, find Bayarcash and activate it.

Add your keys and choose channels

On the Bayarcash settings, fill in these fields:

Field	What to enter
Personal Access Token (PAT)	Your Bayarcash token.
Portal Key	The portal that should receive the payments.
API Secret Key	Your secret key. Keep it private.
Sandbox Mode	Turn on only for testing, with sandbox keys.
Payment Information	Text shown on the invoice page.
Successful Payment and Unsuccessful Payment	The page the client lands on after paying or failing: Specific Invoice, List Invoice or Client Area.
Payment Channels	The channel numbers to offer, separated by commas.

Click Save Changes when done. The channel numbers are:

Number	Channel
1	FPX Online Banking
4	FPX Line of Credit (Credit Card Account)
5	DuitNow Online Banking/Wallets
6	DuitNow QR
7	SPayLater
8	Boost PayFlex
9	QRIS Indonesia Online Banking
10	QRIS Indonesia eWallet
11	NETS Singapore

Your Bayarcash account must have a channel enabled before clients can use it. See Payment channels.

Set up the cron job

Bayarcash needs a cron job that checks pending payments every minute. Ask your host to add this, replacing whmcsdomain with your WHMCS domain:

* * * * * wget -q -O /dev/null 'https://whmcsdomain/modules/gateways/bayarcash/bayarcash_cron.php?job=requery'

Add gateway fees to invoices (optional)

Use the Bayarcash Gateway Fees add-on if you want to pass the payment fee to your client. It adds a fee line to the invoice for the channel the client picks. To set it up:

1. Go to System Settings → Addon Modules.
2. Find Bayarcash Gateway Fees and click Activate, then Configure.
3. Under Access Control, tick Full Administrator and save.
4. Open Addons → Bayarcash Gateway Fees.
5. For each channel, set Flat Price (RM) and Percentage Fee (%), then click Save All Settings.

Check the amounts against your own Bayarcash agreement before you save, because the add-on starts with sample values.

Tips

• Test with Sandbox Mode first. Use sandbox keys, pay one test invoice, then switch to live keys and turn it off.
• Keep the cron job running. If it stops, clients may pay but their invoices stay unpaid until you check.

Common issues

My customer sees a message that Bayarcash only accepts payment in MYR.

The invoice is in another currency. Bayarcash accepts MYR only, so issue the invoice in Malaysian Ringgit.

Payments are made but invoices stay unpaid.

Check that the requery cron job runs every minute, and that your Personal Access Token, Portal Key and API Secret Key are correct. The cron job updates pending payments.

A customer sees 'An error occurred. Please try again later.' after choosing a channel.

Check your credentials in the Bayarcash gateway settings. Turn on Sandbox Mode only when you use sandbox keys.

Related articles

• Find your API keys and portal key
• Create and use portals
• Payment channels you can accept with Bayarcash
• Accept Bayarcash payments in HostBill