3. Extract the zip files.

4. You will see 2 folders in the extract files under the folder “upload” which are the folder “admin” and “catalog.” Please take note that these are the files that you need to upload to your OpenCart folder in the server later.

C. Check the existing Payment Gateway with OpenCart

Now, you need to login to your OpenCart and check whether the senangPay payment gateway is already in the list or not. By default, senangPay will not be in the list.

1. Please login to your OpenCart.

2. On the menu, go to Extensions > Payments.

3. You will see a list of existing payment gateways that are already registered with OpenCart. Please take note that senangPay is not yet in the list.

D. Upload the senangPay OpenCart plugin files to OpenCart

Now, you need to upload both folders “admin” and folder “catalog” to your OpenCart folder in your server. You can do this via your cPanel login or via FTP software.

1. Login to your FTP ( or cPanel ) of your server where you host your OpenCart.

2. Browse your OpenCart folder. You will notice that the “admin” and “catalog” folders are already existed in the server.

3. Open your OpenCart folder and you will see both “admin” and “catalogue” folder.

4. Copy both of the “admin” and “catalog” folders that you have uploaded before and upload the folders to the server.

E. Check senangPay Payment Gateway in the list

After you replace both folders, you need to check in your OpenCart Payment list whether the senangPay Payment Gateway is listed or not. You should see senangPay listed if you have uploaded both folders.

1. Please login to your OpenCart.

2. On the menu, go to Extensions > Payments.

3. You should see that the senangPay Payment Gateway is already in the list with status “Disabled.”

F. Enable senangPay OpenCart plugin

Next, you need to enable the senangPay plugin as the plugin is currently disabled. First, you will need to install the senangPay plugin.

1. Go to the Payment listing.

2. On the senangPay list, click the green icon to install.

3. You should see a response from OpenCart telling you that your installation is successful.

4. The previous green icon will change to red color. This means that your senangPay plugin is already installed.

5. On the senangPay list, click on the blue icon to edit.

6. You will see a new page with spaces to fill.

7. You need to get the Merchant ID and Secret Key from your senangPay Dashboard.

G. senangPay Shopping Cart integration link

Next, you need to get your Merchant ID and Secret Key.

1. Login to your senangPay Dashboard.

2. Go to Menu > Settings > Profile.

3. Scroll down the page until you see the “Shopping Cart Integration Link” section.

4. Copy the “Merchant ID” number and the “Secret Key” number.

5. Next, you need to insert your OpenCart URL inside the Return URL field in the senangPay Dashboard. The URL is :

http://yourwebstore.com/?route=extension/payment/senangpay/callback&

• The URL above is based on the assumption that you have installed OpenCart in your base directory.
• Please change yourwebstore.com to your domain name accordingly.

6. Then, insert your Callback URL field as follows:

http://yourwebstore.com/?route=extension/payment/senangpay/callback_response&

7. Lastly, click ‘Save’. For more info on Callback URL, read here.

H. OpenCart Setting

Now, this is almost the last part. Finalizing the OpenCart setting.

1. On the previous senangPay setting page, insert the information that you have copied before.

2. Insert your “Merchant ID” that you copied from your senangPay Dashboard.

3. Insert your “Secret Key” that you copied from your senangPay Dashboard.

4. On the Order Status, select “Processed”. You can also select other preference based on your business process. The order status is the new status for the order after the payment was made.

5. On the Status, select “Enable”

6. Last, click “Save,” on the top right of the setting page.

7. When you go back to the payment listing page, you’ll see that the senangPay payment gateway is already enabled.

I. Testing your integration

Now, this is the last part. You need to test your integration whether its working or not.

1. Go to your OpenCart front end store.

2. Select any product, and add to cart.

3. Then, proceed to Checkout.

4. You will see senangPay in the Payment Method tab as below.

5. When you confirm order, you will be directed to senangPay Payment Form.

6. Congratulations, your Online Business is now on another triumph level!

J. If you are not using the default theme of OpenCart

1. If you are not using the default theme of OpenCart, then, you need to create a folder called ‘payment’ in your theme folder and copy files “senangpay_failed.tpl” and “senangpay.tpl” into your theme folder.

2. Make sure the folder catalog/view/theme/your_theme_folder/payment/ contains the 2 files.

K. How do I know that I’m not using the default theme for OpenCart

If your site does not look like the image below, then you are not using the default theme.

L. Common mistake

If you encounter the error as below:

Notice: Error: Could not load template /home/xxxxx/public_html/xxxxx/catalog/view/theme/xxxxx/payment/senangpay.tpl! in /home/xxxxx/public_html/xxxxx/system/storage/modification/system/engine/loader.php on line 86

• please refer to the section “If you are not using the default theme of OpenCart” above and check that you have copied the 2 files in your theme payment folder.

M. Previously known issue

1. Previously, we received several complaints regarding the absence of order/purchase on the merchant’s website, but senangPay has recorded the purchase on the Transaction list in the Dashboard.

2. Merchant can search for the mysteriously “missing” order by going to the “Missing order” list in the OpenCart admin page.

3. However, this issue has been fixed in our latest plugin.