How to install and set-up the Magento plugin

Created by Isaac Harper, Modified on Tue, 21 Nov 2023 at 06:34 PM by Isaac Harper

Our plugin for Magento stores allows you to quickly add account-to-account payments to the checkout of your Magento store. Just follow the instructions below


Please note: We recommend first testing the plugin with a sandbox integration before going live on your website.

Prerequisites

Before following this guide you need to provide read/write permissions. To do this, go to the root directory mostly var/www/htlm and grant permissions for read write Sudo chmod -R 777 magento



1a. Manual Installation Steps (Installing the extension by copying code) 

  1. Extract files from an archive
  2. Deploy files into Magento2 folder `app/code/`

 






1b. Installation through composer 


    Go to the Magento Directory – e.g., cd /var/www/html

    Switch to root user - sudo -i (Only if you are facing issues with any below commands.)


    composer require fenalabs/module-payments


    Fena payments extension will be added to vendor folder.



2. After the successful installation run the below command on Magento2 root directory:

>> php bin/magento setup:upgrade

>> php bin/magento module : status

>> php bin/magento module:enable Fenalabs_Payments

>> php bin/magento setup:upgrade

>> php bin/magento setup:static-content:deploy -f

>> php bin/magento cache:flush

>> chmod -R 777 var/ && chmod -R 777 pub/ && chmod -R 777 generated/


Clear Magento cache and your Fena Extension will be installed. 



3. Configure fena


Go to the Stores > Configuration > Sales > Payment Methods.


Here, you will need to provide the Fena Terminal ID and Terminal Secret.


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.


Once your account is verified, add a new integration 

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




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 Magento and copy the value next to Payment Notification URL. Then, paste it here. 
  3. Redirect URL:  Go back to the configuration page in Magento and copy the value next to Redirect URL. Then, paste it here.


  1. Select the bank account you want linked to your Magento store

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

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

  4. 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 unselected. Just be aware when you want to go live you’ll need to add a new, live integration. Detailed instructions can be found here.



Copy over your terminal ID and secret to Magento

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 Fena Terminal ID and Fena Terminal Secret Key fields in Magento, found in Stores > Configuration > Sales > Payment Methods.







And that's it, you're ready to start taking fena payments on your store!



 


How will fena look?


This is how the fena payment option looks in the checkout:



 


And in the Admin order view:



  



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