How to install and set-up fena for OpenCart 3

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