How to install and set-up fena for OpenCart 3

Created by Isaac Harper, Modified on Wed, 15 Mar 2023 at 05:17 PM by Isaac Harper

This guide is for OpenCart 3, if you are running OpenCart 4, please see the guide here



Download the extension


First, you need to download the extension. You can do this two ways:

1a. Download from OpenCart marketplace


1b. Download from out GitHub repo 


Download the extension here: https://github.com/fena-co/fena-opencart3.0-gateway 

Please note: If you have downloaded the extension from our GitHub repo, then you need to rename the extension such that it ends with filename.ocmod.zip 


Upload and install the extension


Next, you need to upload the extension.


1. Navigate to extensions > Installer > Upload the file







2. Once uploaded, you will see the file displayed in the Installer:




3. Navigate to Extensions, and select the extension type “Payments”. 





4. After selecting this, the fena extension will display in the list. You now need to install the payment method by clicking the green ‘+’ button



Set-up the extension

1. Once installed, you need to configure the plugin:


2. Installation requires a terminal ID and terminal secret to be generated and inputted.


3. To generate this, you need to login/register for fena    

To generate the ID and secret, you need a fena account. If you don’t have one, you can sign-up at https://business.fena.co/register/. Detailed sign-up instructions can be found here.


4. Once your account is verified, add a new integration 

    Navigate to https://business.fena.co/dashboard/settings/integrations/  


5. Then hit ‘+ New website or app’ and fill in the following fields:

        

1. Website / App Name: With the name of your shop 

2. Webhook / Payment Notification URL: Go back to the configuration page in OpenCart and copy the value next to Payment Notification URL. Then, paste it here. 

3. Redirect URL:  Go back to the configuration page in OpenCart and copy the value next to Redirect URL. Then, paste it here. 

4. Select the bank account you want linked to your OpenCart store

5. Decide whether or not you'd like to receive payment notifications for payments 

6. Decide if you want this to be a live integration or a test/sandbox integration*

7. Click ‘Create’ 


*If you want to test the plugin without making any live transactions, follow the same steps but after selecting your bank account, make sure the “Live” option is unticked. Just be aware when you want to go live you’ll need to add a new, live integration. Detailed instructions can be found here.


6. Copy over your terminal ID and secret to OpenCart

Open the integration you created in the previous step. Just click into it and copy and paste the terminal ID and terminal secret from fena into the Terminal ID and Terminal Secret fields in OpenCart





7. Make sure it’s all saved and your done

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article