Accept Bayarcash payments in OpenCart

The Bayarcash module lets your OpenCart shop take payments through Bayarcash. It comes as one zip file for OpenCart 3 and another for OpenCart 4. Use the one that matches your store.

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

Before you start

You need the following:

• An approved Bayarcash merchant account with your payment channels enabled.
• Your Personal Access Token, API Secret and Portal Key. See API keys and Portals.
• Malaysian Ringgit (MYR) set up as a currency in your store.

Install the module

Download the module zip file from the Bayarcash plugin page. Then:

1. In the OpenCart admin, go to Extensions → Installer and upload the zip.
2. Go to Extensions → Extensions and choose the Payments type.
3. Find Bayarcash in the list. Click Install, then Edit.

Add your keys

The settings open on the API details tab. To fill it in:

1. Keep or change Payment Name. This is the name customers see at checkout.
2. Paste your Personal Access Token, API Secret and Portal Key.
3. Leave Sandbox Mode off for real payments. Turn it on only with sandbox keys.
4. Save. OpenCart checks your token when you save.

Choose channels and turn it on

Next, open the General tab:

1. Under Payment Channels, select the channels to offer. Hold Ctrl or Cmd to pick several.
2. Set Status to on.
3. Save.

Customers then see each channel at checkout, named after your Payment Name, for example “Bayarcash - Credit Card”.

Other settings

These tabs are optional:

Tab	What it does
Order status	Sets the status for Canceled Order Status, Failed Order Status and Paid Order Status.
Customize checkout	Instruction shows your own text before the customer pays.
Troubleshoot	Debug logging writes details to the OpenCart error log.

Tips

• Test before you go live. Turn on Sandbox Mode with sandbox keys, place one order, then turn it off and use your live keys.
• Check Sandbox Mode first if live payments fail. It must be off for real payments.

Common issues

Checkout shows 'Bayarcash requires MYR currency to be set-up.'

Add Malaysian Ringgit (MYR) as a currency in your store. Bayarcash processes MYR only. Other currencies work only if Convert To Processing is on.

I cannot save the settings because of a missing field.

Personal Access Token, API Secret, Portal Key and Payment Name are all required. If you turn on Instruction, Bayarcash Instructions is required too.

Saving the settings shows the text error_invalid_token or error_pat_required.

These are unfinished error messages. They mean the Personal Access Token is empty or Bayarcash did not accept it. Copy the token again from your merchant dashboard and save.

Customers see 'Invalid redirect.' or 'Payment method is incorrect!' at checkout.

Ask the customer to go back to checkout and choose the Bayarcash payment method again. If it keeps happening, turn on Debug logging on the Troubleshoot tab and share the OpenCart error log with support.

Related articles

• Find your API keys and portal key
• Create and use portals
• Payment channels you can accept with Bayarcash
• Check a transaction and its status