Novalnet Payment Module for Magento
Total Page:16
File Type:pdf, Size:1020Kb
Feringastr. 4 85774 Unterföhring Germany Tel: +49 89 9230683-19 Fax: +49 89 9230683-11 Installation Guide for Novalnet Magento Module Version Date Remarks 12.1.2 18.08.2021 [Fix] Adjusted the Callback/Webhook to restrict replicating of invoice mail generation [Enhanced] Credit/Debit Cards payment method description For previous version changelog, go to https://github.com/Novalnet-AG/magento2-payment-integration-novalnet/blob/master/changelog.txt NOVALNET AG Tel.: +49 89 9230683-19 Board of Directors: Gabriel Dixon (CEO), Johnson Rajdaniel (CFO) Payment Institution Fax: +49 89 9230683-11 Chairman of the supervisory Board: Frank Haussmann Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139 TABLE OF CONTENTS 1 QUICK SETUP .................................................................................................................................. 3 1.1 Module Installation .............................................................................................................................. 3 1.1.1 Module Installation via Composer ..................................................................................................... 3 1.1.2 Module Installation via Package ........................................................................................................ 5 1.2 Upgrading the Novalnet Payment Module........................................................................................... 6 1.3 Global Configuration in the Magento shop system .............................................................................. 8 1.3.1 Notification/Webhook configuration in the Novalnet Admin Portal ............................................... 9 1.3.2 Client key configuration in the Novalnet Admin Portal .................................................................. 11 1.4 Payment Activation in the Novalnet Admin Portal ............................................................................ 12 1.5 Payment Configuration in the Magento shop system ........................................................................ 15 2 TESTING AND GOING LIVE ............................................................................................................. 17 3 ADDITIONAL CONFIGURATION ...................................................................................................... 17 3.1 Additional configuration for all the payment methods ...................................................................... 17 3.2 Additional configuration for Credit/Debit Cards ................................................................................ 23 3.3 Additional configuration for Apple pay Payment ............................................................................... 23 4 MANAGING MAGENTO ADMIN PANEL .......................................................................................... 24 4.1 Order Management ............................................................................................................................ 24 4.2 Transaction Overview ......................................................................................................................... 25 4.3 Order details for Instalment payments .............................................................................................. 26 4.4 Confirming / Cancelling a transaction ................................................................................................ 26 4.5 Refunding an order ............................................................................................................................. 28 4.5.1 Full Refund ....................................................................................................................................... 28 4.5.2 Partial Refund ................................................................................................................................... 29 4.6 Refunding instalment orders .............................................................................................................. 30 5 UNINSTALLATION ......................................................................................................................... 31 6 TECHNICAL SUPPORT THROUGH NOVALNET .................................................................................. 32 NOVALNET AG Tel.: +49 89 9230683-19 Board of Directors: Gabriel Dixon (CEO), Johnson Rajdaniel (CFO) Payment Institution Fax: +49 89 9230683-11 Chairman of the supervisory Board: Frank Haussmann 2 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139 1 QUICK SETUP This guide describes the quick installation procedure of Novalnet payment module (this guide comes along with the module), to integrate it with your shop system and to start accepting payments worldwide. For this integration, a Novalnet merchant account is needed to accept Novalnet payments, so please make sure that you have received your merchant account details from our sales team. If not, drop a mail to [email protected] This Novalnet payment module package version (12.1.2) supports the following versions of Magento 2: 2.3.0 – 2.4.3 To get started: 1. Log in to the Novalnet Admin Portal with your merchant account details (user credentials) and 2. Log in to your Magento shop system. 3. Make sure that you have extracted the payment module package from the zip file you have received. If you have received only the installation guide without the payment module package (zip file), install the payment module via composer. 1.1 Module Installation 1.1.1 Module Installation via Composer To install the latest Novalnet payment module via composer, please follow the below steps, Step 1: Log in to Magento Marketplace with the username and password you used to purchase the extension. Step 2: In the upper-right corner, click Your name My Profile and open the Access Keys page in your Marketplace account as shown below Figure 1 Step 3: Make sure that you have Access Keys created for your Magento account, other wise click on the Create a New Access Key button, and the keys will be generated automatically. Figure 2 NOVALNET AG Tel.: +49 89 9230683-19 Board of Directors: Gabriel Dixon (CEO), Johnson Rajdaniel (CFO) Payment Institution Fax: +49 89 9230683-11 Chairman of the supervisory Board: Frank Haussmann 3 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139 Use the Public key as your username and the Private key as your password Step 4: Go to My Purchases and find the Novalnet extension to install and click Technical Details as shown below. Figure 3 Step 5: Run the following command in your terminal from the shop root directory composer require novalnet/module-payment Figure 4 Step 6: Now, enter the Username and Password which you generated in the Step 3 for authorize. Figure 5 Step 7: To verify whether the Novalnet payment module has been activated properly, execute the following command. php bin/magento module:status Figure 6 Step 8: In your terminal, from shop root directory execute the following command to enable the Novalnet payment module. Figure 7 NOVALNET AG Tel.: +49 89 9230683-19 Board of Directors: Gabriel Dixon (CEO), Johnson Rajdaniel (CFO) Payment Institution Fax: +49 89 9230683-11 Chairman of the supervisory Board: Frank Haussmann 4 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139 Step 9: Run the following command in your terminal, to proceed further php bin/magento setup:upgrade Figure 8 Step 10: After upgrading, you will be asked to re-run the Magento compile command. To proceed further, execute the following php bin/magento setup:di:compile Figure 9 Step 11: Execute the following command to deploy static-content files (images, CSS, templates and js files) php bin/magento setup:static-content:deploy -f Figure 10 Once you have installed the payment module through composer, skip the section 1.1.2 Module Installation via Package. 1.1.2 Module Installation via Package If the payment module is not installed through composer, please go to your shop system and follow the steps below to install. Step 1: Upload the contents of the NovalnetGateway folder (which you have extracted from the payment module package/zip file) into the Root_Directory as shown below Figure 11 NOVALNET AG Tel.: +49 89 9230683-19 Board of Directors: Gabriel Dixon (CEO), Johnson Rajdaniel (CFO) Payment Institution Fax: +49 89 9230683-11 Chairman of the supervisory Board: Frank Haussmann 5 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139 Step 2: In your terminal, from shop root directory execute the following command to enable the Novalnet payment module. php bin/magento module:enable Novalnet_Payment Figure 12 Step 3: To verify whether the Novalnet payment module has been activated properly, execute the following command. php bin/magento module:status Figure 13 Step 4: To get the changes reflected in the shop system follow the Steps 9 - 11 given in the section 1.1.1 Module Installation via Composer 1.2 Upgrading the Novalnet Payment Module To upgrade the latest Novalnet payment module from the Magento marketplace, please follow the below steps. If you have installed through composer, upgrade the module only through composer. If you have installed the module via package, upgrade the module only through