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.1 07.07.2021 [Fix] Adjusted the redirect payment methods to adapt to the latest shop version 2.4.2-p1 [Fix] Callback/Webhook order status update during credit payments [Fix] Invoice mail generation for every transaction captured for invoice payments in the shop admin  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 ...... 4

1.2 Upgrading the Novalnet Payment Module...... 5

1.3 Global Configuration in the Magento shop system ...... 7

1.3.1 Notification/Webhook configuration in the Novalnet Admin Portal ...... 8

1.3.2 Client key configuration in the Novalnet Admin Portal ...... 10

1.4 Payment Activation in the Novalnet Admin Portal ...... 11

1.5 Payment Configuration in the Magento shop system ...... 13

2 TESTING AND GOING LIVE ...... 15

3 ADDITIONAL CONFIGURATION ...... 15 3.1 Additional configuration for all the payment methods ...... 15

3.2 Additional configuration for Credit/Debit Cards ...... 21

3.3 Additional configuration for Payment ...... 22

4 MANAGING MAGENTO ADMIN PANEL ...... 23 4.1 Order Management ...... 23

4.2 Transaction Overview ...... 23

4.3 Order details for Instalment payments ...... 24

4.4 Confirming / Cancelling a transaction ...... 25

4.5 Refunding an order ...... 26

4.5.1 Full Refund ...... 26

4.5.2 Partial Refund ...... 27

4.6 Refunding instalment orders ...... 29

5 UNINSTALLATION ...... 29

6 TECHNICAL SUPPORT THROUGH NOVALNET ...... 30

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.1) supports the following versions of Magento 2:

2.3.0 – 2.4.2-p1 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: Run the following command in your terminal from the shop root directory composer require novalnet/module-payment

Figure 1 Step 2: Run the following command in your terminal, to proceed further php bin/magento setup:upgrade

Figure 2 Step 3: 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 3

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

Step 4: Execute the following command to deploy static-content files (images, CSS, templates and js files) php bin/magento setup:static-content:deploy -f

Figure 4 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 5 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 6

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 3: To verify whether the Novalnet payment module has been activated properly, execute the following command. php bin/magento module:status

Figure 7 Step 4: To get the changes reflected in the shop system follow the Steps 2 - 4 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 file server.

Step 1: It is recommended to take a proper backup before deleting the existing Novalnet payment module for disaster recovery. Step 2: To remove the Novalnet payment module, run the following command in your terminal from the shop root directory rm -rf app/code/Novalnet

Figure 8 Step 3: Upload the contents of the NovalnetGateway folder into the Root_Directory as shown below

Figure 9

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 4: To get the changes reflected in the shop system follow the Steps 2 - 4 given in the section 1.1.1 Module Installation via Composer If you are facing file permission issues while executing the commands in the terminal, please give full permission to following folders and continue the execution.  app  generated  pub  var Step 7: After Novalnet payment module installation, navigate to STORES  Configuration as shown below

Figure 10 Step 8: Navigate to SALES  Payment Methods  OTHER PAYMENT METHODS  Novalnet and click Configure 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 6 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

1.3 Global Configuration in the Magento shop system The main configuration occurs in your Magento shop system as well as in the Novalnet Admin Portal. In your Magento shop system navigate to STORES  Configuration  SALES  Payment Methods  OTHER PAYMENT METHODS  Novalnet and click Configure. Enter the following keys under Configuration as shown below:  Product Activation Key - a unique token which is used for merchant authentication and payment processing.  Payment Access Key – a secret key that encrypts the data to avoid user manipulation and fraud.

Figure 12 To get your Product activation key and Payment access key, go to the Novalnet Admin Portal, navigate to PROJECT menu and click icon on the right to view your project details as shown below

Figure 13 Click Shop Parameters and copy API Signature (Product activation key) and Payment access key as shown below

Figure 14

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 7 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Paste the Product activation key and Payment access key in the respective fields and click Activate in your shop system. Next, choose the Tariff ID that you have created in the Novalnet Admin Portal for this Magento shop system. Tariff ID is a unique identifier created based on the tariff type at Novalnet. Select your preferred Tariff ID from the drop-down menu and click Save Config as shown below:

Figure 15 1.3.1 Notification/Webhook configuration in the Novalnet Admin Portal In the Configuration section in your shop system you will find your Notification / Webhook URL under Notification / Webhook URL Setup. Click Configure to link your Notification / Webhook URL to the Novalnet Admin Portal as shown below. Notification / Webhook URL is available as a default setting which is common for all stores.

Figure 16

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 8 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

After successful configuration, your shop Webhook URL will be linked with your Novalnet Merchant account in the Novalnet Admin Portal under Vendor script URL/ Notification & Webhook URL field of your desired project as shown below

Figure 17 In your shop system, you can additionally test the Webhook URL manually and send notification email to specific email address as shown below

Figure 18  Notification / Webhook URL - Required to keep the merchant’s database/system up to date and synchronized with Novalnet always (for example: up-to-date transaction status delivery).  Allow manual testing of the Notification / Webhook URL - Enable this to test the Novalnet Notification / Webhook URL manually. Disable this before setting your shop system into live, to block unauthorized calls from external parties.  Send e-mail to - Every execution will be sent as a message to the e-mail address defined in this field.

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 9 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

1.3.2 Client key configuration in the Novalnet Admin Portal The client key is a unique key which is linked with your Novalnet merchant account to authenticate your client based requests. You need the client key to render the secure payment form and tokenize (temporarily) the sensitive information. Novalnet allows client-side request(s) only from the whitelisted domains under a particular project so you must whitelist your domains in the Novalnet Admin Portal. The whitelisted domain should always be a valid (secured https://) website. Please follow the below steps to whitelist the domains in the Novalnet Admin Portal. You can configure multiple domain URLs under a single client key. Step 1: Go to the Novalnet Admin Portal with your Novalnet merchant account details. Step 2: Navigate to the PROJECT menu and click view icon on the right to view your project details as shown below

Figure 19 Step 3: On the project details page click Shop Parameters and click beside Allowed Domain(s) as shown below

Figure 20 Step 4: Paste your webshop URL in the Domain name field and click the + Add as shown in below

Figure 21

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 10 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Step 5: After successfully adding the Domain name, the web URLs are listed under Allowed Domain(s) as shown below

Figure 22 1.4 Payment Activation in the Novalnet Admin Portal All the Novalnet supported payment methods can be viewed here: www.novalnet.com/payment if you have questions about the payment methods or additional payment method requests, please contact [email protected] To activate the preferred payment methods for your webshop, go to the Novalnet Admin Portal, and navigate to the PROJECT  Payment Methods  Edit Payment Methods in the top right corner as shown below

Figure 23

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 11 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Now select the preferred payment methods and click Update to activate them as shown below

Figure 24 To use the PayPal payment method, configure the PayPal API details in Novalnet Admin Portal as shown below

Figure 25

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 12 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

To use the PostFinance payments, configure Ep2-Merchant ID details in Novalnet Admin Portal as shown below

Figure 26 1.5 Payment Configuration in the Magento shop system After activating the payment methods in the Novalnet Admin Portal, you must enable these payment methods in your shop system to display them on your Magento checkout page. Navigate to STORES  Configuration  SALES  Payment Methods  OTHER PAYMENT METHODS  Novalnet and click Payments as shown below

Figure 27

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 13 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Figure 28 Choose the payment method and select Yes on Display payment method drop down to display that on the shop checkout page.

Figure 29

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 14 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Refer chapter 3 ADDITIONAL CONFIGURATION for more payment configurations.

 If you have any recommendations or suggestions for improvement, kindly share your thoughts with us to develop our payment module further [email protected] or call us at +49 89 9230683-19.  Are you happy with our service and support? Please spend a few minutes to share your success here 2 TESTING AND GOING LIVE Execute test transactions by navigating to Configuration, unselect the preferred payment methods in Enable Live Mode list that you wish to test. In the test mode the transaction amount will not be charged by Novalnet.

Figure 30  Refer below URL for the Novalnet test payment data for testing https://developer.novalnet.de/testing Execute orders in LIVE MODE To proceed with LIVE orders, Don’t forget to uncheck/disable the Enable test mode option in the individual payment configuration page.  If you have any recommendations or suggestions for improvement, kindly share your thoughts with us to develop our payment module further [email protected] or call us at +49 89 9230683-19.  Are you happy with our service and support? Please spend a few minutes to share your success here 3 ADDITIONAL CONFIGURATION 3.1 Additional configuration for all the payment methods For additional payment configuration settings for each payment methods, navigate to STORES  Configuration  SALES  Payment Methods  OTHER PAYMENT METHODS under Novalnet click on Payments then choose the payment methods and configure the required additional payment settings. Title Enter the title that will be displayed in the checkout page.

Figure 31

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 15 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Define a sorting order The payment methods will be listed on your checkout (in ascending order) based on your given sorting order.

Figure 32 Payment due date (in days) Payment due date (in days) refers to the duration (number of days) given for buyer to complete the payment. The payment process and duration may differ for each payment method.  This option is available only for the following payment methods: Direct Debit SEPA, Direct Debit SEPA with payment guarantee, Instalment by Direct Debit SEPA, Invoice Prepayment and Barzahlen/viacash.

Figure 33  For Direct Debit SEPA, Direct Debit SEPA with payment guarantee & Instalment by Direct Debit SEPA, enter the number of days after which the payment is debited (must be greater than 7 days).  For Invoice, enter the number of days given to the buyer to transfer the amount to Novalnet (must be greater than 7 days). If this field is left blank, 14 days will be set by default.  For Prepayment, enter the number of days given to the buyer to transfer the amount to Novalnet (must be greater than 7 days). If this field is left blank, 14 days will be set by default.  For Barzhalen/viacash, enter the number of days given to the buyer to pay at a store near by. If this field is left blank, 14 days will be set by default for slip expiry. Payment Action (Debit immediately / Reserve funds for later)  This option is available only for the following payment methods: Credit/Debit Cards, Direct Debit SEPA, Direct Debit SEPA with payment guarantee, Instalment by Direct Debit SEPA, Invoice, Invoice with payment guarantee, Instalment by Invoice, PayPal and Applepay. You can choose between two options – Capture and Authorize which are both explained below.  Capture - This is the default setting where transactions are directly confirmed, and funds are automatically transferred from buyer’s account to the merchant account. This can be changed as per your business requirement.

Figure 34

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 16 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

 Authorize - Payment details are verified while the funds are reserved, which will be captured later. Please note for card payments, if you fail to execute a capture within 14 days the reservation on the card will automatically expire!  Minimum transaction amount for authorization - Transactions above this amount will be “authorized” only and captured later. Leave the field blank to authorize all transactions.

Figure 35 Completed order status Set the status that will be used for completed orders.

Figure 36 Callback / Webhook order status  This option is available only for the following payment methods: Invoice, Prepayment, Barzahlen/viacash and Multibanco. Set the status that will be applied for orders when webhook/callback script returns successful payment status.

Figure 37

Notification for the buyer Text entered in this field will be displayed on the checkout page. The message can be for example: Thank you for shopping with us.

Figure 38 User Group Excluded Select the user group to whom the payment method should be displayed in the checkout page.

Figure 39

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 17 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Payment from Applicable Countries Select the countries to which the payment method should applicable or to display in the checkout page.

Figure 40 After choosing Specific Countries from drop down, choose the countries in Payment from Specific Countries list as shown below

Figure 41 Minimum Order Total (in EUR) Enter the minimum order amount required to display the chosen payment method (for example ) on your checkout page. If the order is less than this amount, the chosen payment method will not be displayed on the checkout.

Figure 42

Maximum Order Total (in EUR) Enter the maximum order amount required to display the chosen payment method (for example credit card) on your checkout page. If the order is less than this amount, the chosen payment method will not be displayed on the checkout.

Figure 43

Minimum number of orders count Enable this payment method for the customer only when they exceed the minimum number of orders including their previous orders on your checkout.

Figure 44

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 18 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Payment guarantee configuration When the basic requirements (shown in the image below) are met, Novalnet offers you the option to process payments as guarantee payments. For more information about Novalnet’s guarantee payments, Please visit: https://developer.novalnet.de/onlinepayments/aboutguarantee  This option is available only for the following payment methods: Direct Debit SEPA with payment guarantee and Invoice with payment guarantee.

Figure 45 Force Non-Guarantee payment  This option is available only for the following payment methods: Direct Debit SEPA with payment guarantee and Invoice with payment guarantee. Enable this option to process payments as non-guarantee payment when the guarantee conditions are not met.

Figure 46 Allow B2B Customers  This option is available only for the following payment methods: Direct Debit SEPA with payment guarantee, Invoice with payment guarantee, Instalment by Direct Debit SEPA and Instalment by Invoice.

Enabling this option will allow B2B buyers to complete payments in your shop system.

Figure 47

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 19 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Instalment payment configuration When the basic requirements (shown in the image below) are met, Novalnet offers you the option to process payments as instalment payments. For more information about Novalnet’s instalment payments, Please visit: https://developer.novalnet.de/onlinepayments/aboutinstalment   This option is available only for the following payment methods: Instalment by Direct Debit SEPA and Instalment by Invoice.

Figure 48 Instalment cycles Instalment cycle refers to the pre-defined period for partial payments that allow the buyer to pay their full order amount in parts. The intervals or cycles vary based on shop admin configuration. This option is available only for the following payment methods: Instalment by Direct Debit SEPA and Instalment by Invoice. Define which installment cycles you wish to offer in your shop (e.g. 2 cycles, 3 cycles, 4 cycles, 6 cycles etc.) and click Save Config. The buyer can then choose among these instalment cycles, if they wish to pay in instalments.

Figure 49

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 20 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

The pre-defined instalment details will be visible for the buyer under the chosen instalment payment method as shown below

Figure 50 3.2 Additional configuration for Credit/Debit Cards Enforce 3D secure payment outside EU By enabling this option, all payments from cards issued outside the EU will be authenticated via 3DS 2.0 SCA.

Figure 51 Form appearance If you wish to change the default design of the Credit/’s form (for example to use your corporate identity), you can do it here. Leave this field unchanged to use the default settings.

Figure 52

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 21 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

3.3 Additional configuration for Apple pay Payment Seller Name This is the text that appears as PAY SELLER NAME in the Apple Pay modal payment sheet.

Figure 53 Button Type Select the button type for Apple Pay from this drop-down.

Figure 54 Button Theme Select the button theme for Apple Pay from this drop-down.

Figure 55 Button Height Set the button height for Apple Pay, ranging between 30 to 64 pixels.

Figure 56 Button Corner Radius Set the corner radius of the button for Apple Pay, ranging between 0 to 10 pixels.

Figure 57 Display Apple Pay Button in Choose where to display the Apple Pay button in the shop frontend.

Figure 58

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 22 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

4 MANAGING MAGENTO ADMIN PANEL 4.1 Order Management Manage your orders and view their details under SALES  Orders in your Magento admin panel as shown below

Figure 59 4.2 Transaction Overview Click the View of a particular order ID to review the Novalnet transaction details for that order.

Figure 60

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 23 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Navigate to Information menu and the actual transaction details will be displayed under Payment Information as shown below

Figure 61 4.3 Order details for Instalment payments To review the completed and pending payments for a particular instalment order, choose the particular order and click the Instalment menu, then scroll down to the Instalment Summary section as shown below

Figure 62

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 24 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

4.4 Confirming / Cancelling a transaction Depending on your “Payment action” configuration the order status might be automatically set to “On hold” if authorization is required for that order. To confirm or cancel the transaction of an “On hold” order, navigate to SALES  Orders in your shop admin panel and select the particular order. To confirm the “On hold” order, click Capture on the order detail page as shown below

Figure 63

Now click Submit Invoice on the capture page as shown below. After manual confirmation, Novalnet will process the transaction.

Figure 64 To cancel the “On hold” order, click Void on the order detail page as shown below

Figure 65

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 25 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Then click OK in the popup as shown below. After you have cancelled the order, Novalnet will cancel the transaction.

Figure 66 After order confirmation or cancellation, the new transaction details will be displayed under Payment Information tab as shown below. Refer to the chapter 4.2 Transaction Overview for more details about the Payment Information.

Figure 67 Figure 68

4.5 Refunding an order 4.5.1 Full Refund You can refund the buyer full order amount. Refund can be initiated by navigating to SALES  Orders  select the order  Invoices  View from the Invoice as shown below

Figure 69

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 26 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Now select Credit Memo and then click Refund as shown below

Figure 70

Figure 71 Once the full order amount is refunded, the order status will be changed and a new transaction (TID) will be generated. You will see the new transaction details under Payment Information of the order. Refer to the chapter 4.2 Transaction Overview for more details about the Payment Information. 4.5.2 Partial Refund You can refund the buyer’s partial order amount. Refund can be initiated by navigating to SALES  Orders  select the order  Invoices  View from the invoice as shown below

Figure 72

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 27 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Then select Credit Memo as shown below

Figure 73 Set the Qty to Refund value below than an ordered quantity in the Items to Refund table, and click the Update Qty’s, so that Refund Totals will get updated as shown below

Figure 74 Enter the partial order amount in the Adjustment Refund and click Refund.

Figure 75 Once a partial refund of the order amount in done, a new transaction (TID) will be generated. You will see the new transaction details at the same Payment Information of the order.

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 28 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

4.6 Refunding instalment orders To refund an instalment order, navigate to SALES  Orders and click a particular order. Scroll down to the Instalment Summary section under Instalment menu and click Refund next to the completed instalment cycle that should be refunded as shown below

Figure 76 Enter the Refund amount and click Refund as shown below

Figure 77 Once the instalment order amount has been successfully refunded, you will see the new transaction status will be displayed under Payment Information. Refer to the chapter 4.2 Transaction Overview for more details about the Payment Information. 5 UNINSTALLATION To deactivate and delete the Novalnet Payment module, please follow the steps below. Step 1: In your terminal, from shop root directory execute the following command to disable the Novalnet payment module, php bin/magento module:disable --clear-static-content Novalnet_Payment

Figure 78

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 29 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139

Step 2: To remove the Novalnet payment module run the following command in your terminal, from the shop root directory, rm -rf app/code/Novalnet

Figure 79 Step 3: Run the following command in your terminal, to proceed further. php bin/magento setup:upgrade

Figure 80 Step 4: After this, re-run Magento compile command, and execute the following command php bin/magento setup:di:compile

Figure 81 Step 5: Execute the following to deploy static-content files (images, CSS, templates and js files) php bin/magento setup:static-content:deploy -f

Figure 82 6 TECHNICAL SUPPORT THROUGH NOVALNET For any questions or further enquiries please contact one of the following departments as per your requirement. Our in-house experts are ready to assist you in case of queries or issues. For installation assistance contact [email protected] or call +49 89 9230683-19. For a merchant account, new payment module or additional payment methods, please contact [email protected] or call +49 89 9230683-20. If you have any recommendation or suggestion for improvement? Kindly share your thoughts with us to develop our payment modules further [email protected] or call us at +49 89 9230683-19. Are you happy with our service and support? Please spend a few minutes to share your success here. For our License details see for Freeware License Agreement.

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 30 Feringastr. 4 E-mail: [email protected] Commercial register number: HRB 167381 85774 Unterföhring Tax id: DE254954139