Novalnet payment Module for Magento...Novalnet payment Module for Magento Compatible with the...

Gutenbergstr. 2

D-85737 Ismaning Tel.: +49 89 9230683-21 Fax: +49 89 9230683-11

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11

E-Mail: [email protected]

Tax id: DE254954139

Chief Executive Officer: Gabriel Dixon

Board of directors: Johnson Rajdaniel

Chairman of the board: Frank Haussmann

Commercial register number: HRB 167381

Novalnet payment Module for Magento

Compatible with the version: 1.4.2.x - 1.9.4.1

Installation guide Ve

rsio

n 1

1.1

.6

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





2

Contents Changelog file .................................................................................................................................... 4

1. About this document .................................................................................................................. 5

2. Technical specifications .............................................................................................................. 6

2.1 Supported payment methods .......................................................................................................... 6

2.1.1 Credit Cards ................................................................................................................................................ 6

2.1.2 Online Bank Transfer .................................................................................................................................. 6

2.1.3 Bank account related payment options ...................................................................................................... 6

2.1.4 Wallet system ............................................................................................................................................. 6

3. Download and installation .......................................................................................................... 7

3.1 Compatibility and requirements ...................................................................................................... 7

3.2 Download ......................................................................................................................................... 7

3.2.1 Download free from the Magento marketplace ......................................................................................... 9

3.3 Plugin installation ........................................................................................................................... 12

4. Settings ..................................................................................................................................... 13

4.1 Settings in the Novalnet administration portal .............................................................................. 13

4.1.1 IP address for payment calls ..................................................................................................................... 13

4.1.2 API (Activation key of your project) .......................................................................................................... 13

4.1.3 PayPal API-configuration in Novalnet administration portal ..................................................................... 14

4.2 Settings in the shop backend ......................................................................................................... 15

4.3 Basic settings for payment methods .............................................................................................. 18

4.4 Special settings for payment methods ........................................................................................... 20

4.4.1 Credit Card ................................................................................................................................................ 20

4.4.2 Direct Debit SEPA (with payment guarantee) ........................................................................................... 20

4.4.3 Invoice (with payment guarantee) ............................................................................................................ 21

4.4.4 Prepayment .............................................................................................................................................. 21

4.4.5 PayPal ....................................................................................................................................................... 21

4.4.6 Barzahlen .................................................................................................................................................. 22

4.5 Configuration of the fraud check modules .................................................................................... 24

4.5.1 Force 3D secure ................................................................................................................................ 24

4.5.2 PIN by callback & PIN by SMS ............................................................................................................ 25

4.6 Merchant script configuration in Novalnet admin portal .............................................................. 27

4.7 Merchant script configuration in shop backend ............................................................................ 28

4.8 Individual order status management ............................................................................................. 29

5. Orders ....................................................................................................................................... 31

5.1 Order overview .............................................................................................................................. 31

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





3

5.2 Order details .................................................................................................................................. 31

5.3 Transactions ................................................................................................................................... 32

5.3.1 Overview of transactions .......................................................................................................................... 32

5.3.2 Transactions details .................................................................................................................................. 32

5.3.3 Transactions logs ...................................................................................................................................... 32

6. Follow-Up transaction process ................................................................................................. 34

6.1 Confirm/Cancel a transaction ........................................................................................................ 34

6.2 Transaction refund process ........................................................................................................... 35

6.3 Change Due Date ........................................................................................................................... 37

6.4 Expiry date update (Barzahlen) ...................................................................................................... 38

7. Payment Reference .................................................................................................................. 39

8. One click shopping .................................................................................................................... 40

9. Subscriptions ............................................................................................................................ 41

9.1 Suspending subscriptions ............................................................................................................... 43

9.2 Cancel subscriptions ...................................................................................................................... 45

10. Affiliate management system ............................................................................................... 48

11. Uninstalling the Novalnet payment extension ...................................................................... 49

12. Imprint and contact .............................................................................................................. 50

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





4

Changelog file

Version Description & changes Date

11.1.6 [Fix] Fetch the end customer information from the current customer details during subscription renewal [Enhanced] Guaranteed payment pending status has been implemented [Enhanced] Callback has been optimized as per the new testcase

15.09.2018

11.1.5

[New] Custom checkout overlay for Barzahlen [New] Force 3D secure process has been implemented as per predefined filters and settings in the Novalnet admin portal [Enhanced] Due date update notification in the shop, on activation of transaction for Invoice, Invoice with payment guarantee and Prepayment [Enhanced] Date of birth field format has been updated [Enhanced] On-hold transaction configuration has been implemented for Credit Card, Direct Debit SEPA, Direct Debit SEPA with payment guarantee, Invoice, Invoice with payment guarantee and PayPal [Enhanced] Optimized vendor script validation for handling communication failure transaction [Enhanced] Optimized IP condition check for remote address

23.01.2018

11.1.4 [Enhanced] Dynamic IP control applied through domain instead of static IP in vendor

script. Actual IP of Novalnet will be extracted in real time from the domain 21.11.2017

11.1.3

[New] Implemented Barzahlen payment method [New] Implemented due date update option for Invoice and Prepayment in shop admin [Enhanced] Optimized vendor script validation [Enhanced] Merchant Administration Portal link has been updated in shop admin [Removed] Refund with account details from shop admin [Removed] Enable debug mode configuration in Merchant script management

13.09.2017

11.1.2 [Enhanced] Payment module has been optimized [Compatible] Tested up to magento version 1.9.4.0

18.05.2017

11.1.1 [Enhanced] Updated payment logo for Credit Card and Invoice payment [Enhanced] Added new parameter in all API calls

04.04.2017

11.1.0

- Credit Card iframe updated. - One click shopping for Credit Card and PayPal implemented. - Edit option in Credit Card and PayPal for registered customers implemented. - On-hold transactions for PayPal implemented. - New payment method "Przelewy24" added.

16.02.2017

11.0.0

- Auto configuration of vendor credentials. - One click shopping for Direct Debit SEPA. - Iframe and hosted page implementation for Credit Card. - Implemented Direct Debit SEPA with payment guarantee, Invoice with payment guarantee and giropay payments. - Edit option in Direct Debit SEPA for registered customers. - Direct Debit SEPA overlay removed. - Notify URL configuration in shop backend. - Logo control has been implemented in global configuration. - Responsive templates has been implemented.

02.05.2016

10.1.0

- Direct Debit SEPA overlay and Credit Card type removed. - Compatibility has been checked for magento_v_1.4.x-1.9.x along with magento security patch 6788.

16.11.2015

10.0.0 - New release 10.06.2015

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





5

1. About this document This document contains the installation, configuration and usage of the Novalnet payment module for

Magento shop system.

Contact

Novalnet AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Website : https://www.novalnet.de

Tel.: +49 89 92 30 683 - 19

Fax: +49 89 92 30 683 - 11


https://www.novalnet.de/

mailto:[email protected]

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





6

2. Technical specifications

2.1 Supported payment methods

You can offer the following payment methods via our payment module in your shop:

2.1.1 Credit Cards

Visa MasterCard Maestro AMEX CartaSi

JCB Diners Club Discover China UnionPay carte Bleue

Dankort

2.1.2 Online Bank Transfer

iDEAL Instant Bank Transfer Eps (Electronic

Payment-

Standard

giropay Przelewy24

2.1.3 Bank account related payment options

Direct Debit SEPA Direct Debit SEPA with payment guarantee

Invoice Invoice with payment guarantee

Prepayment

Barzahlen Cash on pickup Direct Carrier Billing

2.1.4 Wallet system

PayPal

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





7

3. Download and installation

3.1 Compatibility and requirements

Magento

Version: 1.4.2.0 - 1.9.4.1

Novalnet Requirements

Novalnet merchant account

Novalnet payment module for Magento

If you do not already have a merchant account with Novalnet AG, please contact our sales support team

by e-mail at [email protected]. After receiving your request, we will be happy to provide you with a free

trial account. To test the demo shop, use the following link https://magento.novalnet.de/

3.2 Download

Open the Novalnet Web page using the link below and click on Module Download.

Link: https://www.novalnet.com/modul/magento

Figure 1


https://magento.novalnet.de/

http://www.novalnet.com/modul/modified-payment-module

https://www.novalnet.com/modul/magento

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





8

Once you have successfully filled the required fields, click on the SUBMIT NOW button. After submitting

the payment enquiry request form, the Novalnet support team will contact you to proceed further.

Figure 2

Note:

1. Before installing the Novalnet payment module, please disable previously activated Novalnet payment module.

2. Once uploading the latest Novalnet payment module, please clear the cache in shop backend.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





9

3.2.1 Download free from the Magento marketplace

Click on the link https://marketplace.magento.com/novalnet-novalnet.html To purchase the Novalnet

payment extension free of charge. In the overview Compatible with, you can see which Magento versions

our current payment extension is compatible with. Click Add to Cart to add the Novalnet plugin to your

shopping cart.

Figure 3

https://marketplace.magento.com/novalnet-novalnet.html

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





10

After clicking on the shopping cart, choose Go to checkout and log into your Magento account.

Figure 4

Now click on Place order button.

Figure 5

The order is now complete. Now choose Download.

Figure 6

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





11

In the new window you can download the Novalnet payment extension with the desired version by

clicking on the Download button.

Figure 7

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





12

3.3 Plugin installation

First, extract the files from the NovalnetGateway.zip file or the. tgz file into a separate folder. Copy the

extracted content and paste it into the respective folder of the store root (root directory of your shop).

Contents from the NovalnetGateway.zip or .tgz file

Figure 8

Example root (root directory) of the Magento Shop

Figure 9

Note: To make the changes in the shop backend visible

Empty the cache in your store backend

Log out of the shop backend and re-enter

Compiler mode

If your Magento shop is in compiler mode, please proceed as follows:

1. Navigate the shop backend to System -> Tools -> Compilation

2. Disable the compiler mode by clicking Disable

3. After disabling, proceed as described in 3.3 plugin installation

4. Now activate the compiler mode again and empty the store cache.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





13

4. Settings

4.1 Settings in the Novalnet administration portal

4.1.1 IP address for payment calls

For all API accesses (auto configuration of your project's activation key, loading of credit cards iframe,

status query for transactions, etc.) You must configure the IP address of your server in the Novalnet

merchant portal as follows:

Click on the PROJECTS tab, select your desired project, then click Project Overview. Scroll down and click

the orange button to update Payment Request IP’s. Enter your server IP address, and then click Update.

Figure 10

4.1.2 API (Activation key of your project)

The activation key of your project is used to automatically complete the basic parameters (merchant ID,

auth code, payment access key, Project ID and tariff ID) of your merchant accounts in the shop backend.

This can be found in the Novalnet administration portal. Click on the PROJECTS tab, select your project,

under the Shop Parameters tab, copy the activation key to store it as shown in Figure 13 in the shop

backend.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





14

4.1.3 PayPal API-configuration in Novalnet administration portal

If you would like to use PayPal as your payment method, log into the Novalnet administration portal

under https://admin.novalnet.de and select the desired project under the PROJECTS tab. Now, under

Payment Methods, select PayPal and click Configure.

Figure 11

Enter your PayPal API data here and click on Update.

Figure 12

https://admin.novalnet.de/

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





15

4.2 Settings in the shop backend

The Novalnet payment extension supports the multi-shop function of Magento. Our payment extension

automatically detects which order belongs to which shop. In order to use the multi-shop function, it is

necessary that you configure the individual sub-shops correctly. Based on your chosen subshop (e.g.

English), you can make the payment extension configurations for each individual shop separately. For

each subshop you can therefore create your own project in the Novalnet dealer Portal.

Figure 13

To configure the Novalnet basic settings, navigate to Novalnet -> Configuration -> General.

Figure 14

Alternatively, the basic settings of the payment extension can be configured via System -> Configuration -> from the left menu bar under Novalnet -> General.

Figure 15

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





16

Product activation key

Now paste the copied activation key from the Novalnet merchant portal see 4.1.2 API (Activation key of

your project) in the Product Activation key field.

Figure 16

After registering the API, your other merchant data will be completed automatically.

Note: Please make sure that you do not enter the data manually

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





17

Tariff ID

You can now select the tariff configured in the Novalnet merchant Portal from the dropdown list.

Figure 17

After the successful configuration you can now save the Novalnet main settings.

Field Description

Product activation key

After the installation and configuration of your project in the Novalnet merchant administration, Novalnet AG will provide you with an activation key. When you store this in the shop backend, all basic parameters (Merchant ID, Authentication code, Payment access key, Project ID, Tariff ID) are automatically completed.

Merchant ID The merchant ID is provided by Novalnet AG after the opening of a merchant account.

Authentication code The merchant authentication code is provided by Novalnet AG after opening a merchant account.

Project ID The project ID is a unique identification number of a created merchant project. The merchant can create any number of projects in the Novalnet admin portal.

Tariff ID The tariff ID is a unique identification number for each project you have created. The merchant can create any number of tariffs in the Novalnet admin portal.

Payment access key This is the secure public key for encrypting and decrypting transaction parameters. This is mandatory value for all online transfers, Credit Card-3D secure and wallet systems.

Gateway timeout (in seconds) In case the order processing time exceeds the gateway timeout, the order will not be placed.

Proxy server This option will allow to enble the proxy server option.

Proxy Host Enter the IP address of your proxy server in the following format

IP (Eg. 192.168.1.2)

Proxy Port Enter the port number of your proxy server in the following

format (Eg. 22)

Referrer ID Enter the Referrer ID of the person/company that Novalnet recommended to you

Enable E-mail notification for test transaction

If true, the merchant will receive email notifications about every test order in the web shop.

Display payment method logo Payment method logo will be displayed on the checkout page.

Notify Novalnet updates Notify, if any updates available in Novalnet payment module.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





18

4.3 Basic settings for payment methods

Navigate to Novalnet -> Configuration -> Payment Methods.

Figure 18

To activate/deactivate the respective payment method, select the appropriate payment method and click

on Enable payment method. “Yes” for activation and no for disabling. Now configure additional settings

for the payment methods that you want to activate, and then click .

Note: with "Ctrl" + "mouse click" You can select several fields e.g. for the live mode of certain

payment methods. The payment methods you have selected will be blued out, i.e. in the example below,

the payment methods debit Sepa, purchase on invoice, advance payment and PayPal in Live mode.

Figure 19

Field Description

Enable payment method Merchant can activate/deactivate the payments by using this option.

Novalnet Title Title entered in this field will be displayed on the checkout page

User Group Excluded To exclude groups of customers, write their IDs here (separated by comma). You can find the IDs in the Customers → Customer Groups

Payment from applicable countries Select the country for which the particular payment will be allowed. Also, multiple selection is available. If "All Allowed Countries“ option is selected, the payment will be allowed for all the countries..

Payment from Specific countries Select the country for which the particular payment will be allowed.

Minimum Order Total (in Euro) Minimum order total from which the payment method is displayed to the customer during checkout.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





19

Maximum Order Total (in Euro) Maximum order total for the payment method to be displayed during chekcout.

Minimum Orders Count Default: "0" for disabled check | Minimum count of orders (in the past) needed for the customer to use this payment method.

Notification for the buyer Text entered in this field will be displayed on the checkout page.

Define a sorting order Particular payment method will be sorted among others (in the ascending order) as per the given sort number.

Transaction reference 1 / Transaction reference 2

This reference will appear in your bank account statement.

Note: Please save separately after each configuration of a payment method.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





20

4.4 Special settings for payment methods

4.4.1 Credit Card

Field Description

Enable 3D secure

When activating the 3d-secure, the issuing credit card institution also requests the buyer to enter a password. By activating this option, the issuing bank may be provided with proof that the buyer is actually the cardholder. This reduces the risk of a charge back.

One click shopping With activate (set to "yes") of this option, you offer your registered customers the possibility to make online payments with one click with the use of the payment Account details or card details of previous orders

Customized CSS settings CSS settings for the IFRAME with credit card data. If you want to design the IFRAME yourself, you have the option here. If you leave this field blank, the shop default settings will be used.

Credit Card type

This option allows you to enable/disable credit card types (Visa, MasterCard, American Express, Maestro and Cartasi). A grey deposited credit card type means active

Form appearance

Based on the input under Custom CSS Settings, the form will display in the checkout page. Merchant can customize the form style, based on the needs. In general, the form will display with the shop's default CSS setting.

Set a limit for on-hold transaction (in minimum unit of currency. E.g. enter 100 which is equal to 1.00)

In case the order amount exceeds mentioned limit, the transaction will be set on hold till your confirmation of transaction.

4.4.2 Direct Debit SEPA (with payment guarantee)

Field Description

SEPA payment duration (in days) Number of days after which the payment should be processed (must be greater than 6 days).


Enable auto-fill Payment details are automatically entered into the payment form during the checkout process.

Enable auto-fill for payment data For registered users, the SEPA direct debit information is automatically entered in the payment form.

Enable payment guarantee

Before you can use the SEPA Direct debit with a payment guarantee, you need the activation of this payment method by the Novalnet. Please contact us by e-mail at [email protected] Basic requirements for payment guarantee: Allowed countries: AT, DE, CH. Allowed currency: EUR. Minimum amount of order >= 20,00 EUR. Minimum age of end customer >= 18 Years. The billing address must be the same as the shipping address. Gift certificates/vouchers are not allowed.

Minimum order amount (in minimum unit of currency. E.g. enter 100 which is equal to 1.00)

The value you enter overrides the default value. Note: The amount must be in the range between the minimum order amount (€20.00) up to the maximum order amount (€5,000.00).


NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





21

Force Non-Guarantee payment If the payment guarantee is enabled (true), but the above requirements are not met, the payment is to be made without payment guarantee.



4.4.3 Invoice (with payment guarantee)

Field Description

Payment due date (in days) Enter the number of days within which the payment is to be made at Novalnet (at least 7 days). If this field is empty, 14 days will be set as the default time.

Payment Reference 1 (Novalnet Invoice Reference).

If “Yes”, the Novalnet invoice number is displayed in the order comments.

Payment Reference 2 (TID) If “Yes”, the TID created by Novalnet is displayed in the order comments.

Payment Reference 3 (Order No) If “Yes”, the shop-generated order number is displayed in the order comments.

Enable payment guarantee For more information, see 4.4.2 SEPA Direct Debit -> payment guarantee



4.4.4 Prepayment

Field Description Payment Reference 1 (Novalnet Invoice Reference)

If “Yes”, the Novalnet invoice number is displayed in the order comments.

Payment Reference 2 (TID) If “Yes”, the TID created by Novalnet is displayed in the order comments.

Payment Reference 3 (Order No) If “Yes”, the shop-generated order number is displayed in the order comments.

4.4.5 PayPal

Field Description



In case the order amount exceeds mentioned limit, the transaction will be set on hold till your confirmation of transaction. In order to use this option you must have billing agreement option enabled in your PayPal account. Please contact your account manager at PayPal.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





22

4.4.6 Barzahlen

The cash payment method offers your customers the possibility to pay online purchases with the help

of a paying ticket at the cash registers of over 10,000 partner branches of Barzahlen.de. The partner

branches include renowned supermarket chains such as Rewe, DM, Penny, etc. More information on

cash figures can be found online at https://www.barzahlen.de/de. You can get information about a money receipt via the Novalnet in real time.

Checkout

Figure 20

The payment slip

After a successful order, the customer has the following options to show his payment slip at a partner

branch:

• Display SMS

• Print PDF

• Digital via Apple wallet

Figure 21

https://www.barzahlen.de/de

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





23

Field Description

Slip expiry date (in days)

Enter the number of days within which your customer will pay the amount of the order in a cash partner store near him. If the ticket does not redeem and pay the payment in time, it will expire. If the field is empty, by default it is set to 14 days as the due date.

Note: Please contact our technical Support team by phone at +49 89 9230683-19 or by mail at

[email protected] to receive our test data for payment processing.


NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





24

4.5 Configuration of the fraud check modules

4.5.1 Force 3D secure

We have integrated the Enforced 3D secure fraud module for the Credit Card payment method, if 3D secure is not enabled in the above field, then force 3D secure process as per the "Enforced 3D secure (as per predefined filters & settings)" module configuration at the Novalnet admin portal. If the predefined filters & settings from Enforced 3D secure module are met, then the transaction will be processed as 3D secure transaction otherwise it will be processed as non 3D secure.

Please note that the "Enforced 3D secure (as per predefined filters & settings)" module should be configured at Novalnet admin portal prior to the activation here.

Go to Novalnet -> Configuration -> Payment Methods -> Credit Card in the shop admin panel, to enable the Credit Card Force 3D secure on predefined conditions.

Figure 22

Figure 23

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





25

4.5.2 PIN by callback & PIN by SMS

We have integrated the fraud checking modules PIN by callback and PIN by SMS for the payment methods

mentioned below:

Direct Debit SEPA

Invoice

This service is only available to customers from Germany, Austria and Switzerland. If you want to use one

of the fraud checks, activate it in the Novalnet merchant Portal under PROJECTS -> Select project -> Fraud

Modules -> Edit Fraud Modules.

The activation in the shop backend can be carried out under Novalnet -> Risk and Control.

Figure 24

Select one of the fraud checks and Enter Minimum value of goods for the fraud module (in minimum unit

of currency. E.g. enter 100 which is equal to 1.00).

Figure 25

After configuring the fraud check, click .

PIN by callback

In the first step, the customer must enter his or her telephone number. After entering the telephone

number, authentication is done:

An automatic call gives the customer a 4-digit pin that he or she must enter on their checkout page to

successfully complete the payment. This method allows the customer to be identified in real time and the

fraud intentions can be determined before the order is placed. Since this control is very effective and

inexpensive, it is recommended by the Novalnet for all retailers in the e-commerce sector.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





26

PIN by SMS

After entering the phone number, the customer will receive an SMS to the specified number, which he

must enter on their merchant checkout page to complete the payment successfully. This method also

gives you protection from fraudsters.

Figure 26

Your customer has the option "Forgot your PIN?" The possibility to receive a new SMS including a new

PIN.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





27

4.6 Merchant script configuration in Novalnet admin

portal

The merchant script is necessary to keep your database/system up to date. Your system is notified via the

Novalnet system (asynchronous) about each transaction and its status. Follow the steps below to

correctly store the merchant script URL in the Novalnet Adminportal:

After you have logged in to the Novalnet-Adminportal under https://admin.novalnet.de, select the

desired project under the PROJECTS tab. You are now in the Project Overview. Click Edit Project

Overview and enter your merchant script URL.

Figure 27

Vendor script URL

URL: <URL of your shop>/novalnet_payment/callback

e.g.: https://magento.novalnet.de/novalnet_payment/callback

Figure 28

https://admin.novalnet.de/

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





28

4.7 Merchant script configuration in shop backend

Before you perform this step, please deposit your merchant script URL in the Novalnet admin portal (see

4.6 Merchant script configuration in Novalnet admin portal). You can find the Merchant script

management under Novalnet -> Configuration -> General.

Figure 29

Field Description

Deactivate IP address control (for

test purpose only)

Deactivate IP address control (for test purpose only) This option will allow performing a manual execution. Please disable this option before setting your shop to LIVE mode, to avoid unauthorized calls from external parties (excl. Novalnet). Note: For LIVE, set the value as No.

Enable E-mail notification for callback If "Yes", the callback script message will be sent to the email you have entered at the email address (to).

E-mail address (To) E-mail address of the recipient

E-mail address (Bcc) E-mail address of the recipient for BCC

Send an e-mail using

zend/magento template

E-mail will send based on the selection zend/magento template.

Novalnet vendor script log If "Yes", the merchant script log will be created.

Notification URL Notification URL is used to keep your database/system actual and synchronizes with the Novalnet transaction status.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





29

4.8 Individual order status management

To set the status of a specific payment type, first navigate to the desired pay method under Novalnet ->

Configuration -> Payment Methods.

Completed payment status

Once an order has been successfully created (e.g. by credit card), the status for completed payments is

determined according to your specified status (e.g. Processing).

Figure 30

Invoice/Prepayment/Barzahlen

The callback script is triggered for the payment methods Invoice, Prepayment and Barzahlen. The status

of the order is changed from the Order completion status of the order you have configured here to the

Callback order status if the cash receipt for this transaction has been recorded in the Novalnet.

Figure 31

Paypal/Przelewy24

For the above-mentioned payment types, the status for outstanding transactions is based on the status

you set (for example, Pending payment).

Figure 32

On-Hold Bookings

An on-hold booking keeps the order in wait mode (max. Up to 14 days) until you confirm or reject it

yourself.

If no confirmation or rejection is made within this period, the transaction is automatically canceled.To set the status for on-hold transactions, go to Order status management for on-hold transaction(-s) under Novalnet -> Configuration -> General. You can set the status for confirmed and canceled payments here.

Figure 33

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





30

Field Description

Order completion status Once the order has been placed successfully, the Order completion status of the respective payment will be set as order status.

Callback order status For Invoice, Prepayment and Barzahlen methods, when an end customer transfer the amount to Novalnet then the callback script will be triggered and the order status will be changed to Callback order status.

Cancellation order status Once the order got canceled (or) fully refunded, the Cancellation order status will be set as an order status.

Confirmation order status Once the transaction got confirmed, the order status will be changed to Confirmation order status.

Order status for the pending payment

For PayPal and Przelewy24 payment when the transaction is pending, the order status will be set to Order status for the pending payment.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





31

5. Orders

5.1 Order overview

You can view the orders of the end customers in the left menu bar under Novalnet -> Orders.

Figure 34

5.2 Order details

By clicking on the respective order you will receive an overview of this order.

Figure 35

Here you now have a detailed overview of the transaction. The orange buttons on the right above the

order overview also give you the possibility to create invoices, cancel orders, etc..

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





32

5.3 Transactions

5.3.1 Overview of transactions

To view the Novalnet transactions, click Novalnet -> Transactions -> Transaction overview. All

transactions (including TID, order number, transaction status and customer number) are now displayed.

Figure 36

5.3.2 Transactions details

Click on the transaction you want to get a detailed view of the transaction.

Figure 37

5.3.3 Transactions logs

Navigate to Novalnet -> Transactions -> Transactions Log, if you want to view the API log of a

transaction.

Figure 38

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





33

Novalnet Request Data

Figure 39

Novalnet Response Data

Figure 40

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





34

6. Follow-Up transaction process

6.1 Confirm/Cancel a transaction

To confirm or cancel an on-hold payment, navigate to Novalnet -> Orders and click on the respective

order.

Confirmation

Using the button Novalnet Capture, you can confirm the order manually.

Figure 41

Cancellation

If you want to cancel the order, Click on Void button to re-confirming, the order is now canceled.

Figure 42

Confirmation or cancellation is shown in the order overview in the Payment Information field.

Figure 43

Figure 44

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





35

6.2 Transaction refund process

Via Novalnet AG you have the possibility to repay the full amount or a partial amount for transactions to

end customers. Select the relevant order, the amount of money you wish to refund to the buyer and click

on the Invoices under Information.

Figure 45

Now select the order that has already been paid by the end customer and click on Credit Memo.

Figure 46

Enter the amount to be refunded in the Adjustment Fee field and confirm with the Refund button.

Figure 47

Figure 48

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





36

Then, enter the amount to be refunded in the Adjustment Refund field and confirm with the Refund

button.

Figure 49

Figure 50

The partial or full refund is now shown in the Payment Information field of the respective order.

Note: Once the full or a partial amount has been successfully refunded, the transaction will be

canceled and the order status is changed. In addition, a new TID is generated.

Refund reference

For existing transactions, Refund reference field will be available.

Figure 51

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





37

6.3 Change Due Date

You have the option to change the due date of the payment for orders with purchase on

invoice/prepayment. To do this, select the relevant order, enter any date in future and click on Update

button.

Figure 52

Due date before the change

Figure 53

Due date after the change

Figure 54

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





38

6.4 Expiry date update (Barzahlen)

In the case of payment method Barzahlen, your customer has 14 days by default to pay his payment slip

at a Barzahlen partner store. To change the validity of a payment slip, select the required order. Under

the Change the slip expiry date field, you can now select any date from the calendar where you want the

payment slip to expire for the desired order.

Figure 55

Expiration date of the payment slip before the change

Figure 56

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





39

Expiration date of the payment slip after the change

Figure 57

7. Payment Reference Payment Reference is applicable for Invoice and Prepayment payment methods. You can

activate/deactivate the settings under Novalnet -> Configuration -> Payment Methods.

If "Yes", the respective data is displayed on the invoice of the end customer.

If "No", the respective data will not be displayed on the invoice of the end customer.

Figure 58

Example: Payment Reference 2 (TID): Yes -> The TID created by the Novalnet is displayed in the purpose

on the invoice of the end customer and can therefore be assigned to the cash receipt after the Selected

Payment Reference will be displayed in the Payment Information of the particular order.

Figure 59

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





40

8. One click shopping The One click shopping allows the registered customers to make an online payment with one click by

using the payment account details or card details from previous orders. You can activate this under

Novalnet -> Configuration -> Payment Methods and select payment method. Save the changes.

Figure 60

Credit Card / Direct Debit SEPA / PayPal

After a successful order, the payment type, e.g. Direct Debit SEPA is automatically selected with the

previously specified payment data as a payment method. This means that the buyer can order payment

with one click. If the SEPA direct debit is to be debited from other bank data, it can enter its new data

using the Enter new account details button.

Figure 61

The input mask then looks like this. The Given account details will display the account data of the end

customer that has already been used and can be used again for payment.

Figure 62

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





41

9. Subscriptions You have maximum flexibility in your settings and can offer both a perpetual and a limited subscription

with different variants (dynamic subscription, pre-defined subscription, etc.). As a debiting cycle, every

period from one day is conceivable (e.g. three days, one week, one month, at the beginning of the month,

quarterly, half yearly, yearly, etc.). Novalnet AG takes over the release of the subscription and the

continuous monitoring of incoming payments through a pre-defined and fully automated process.

Through the comprehensive interface (as said completely automated) and also via the admin portal (in

this case manually) of Novalnet AG You can of course also trigger the control automatically or manually

on your own. As an optional service, Novalnet AG offers end customers a user-friendly customer portal

(https://card.novalnet.de) for terminations of perpetual subscriptions. You can of course also have your

own end customer management with the interface of Novalnet AG. Fully automated subscription

management reduces your time: Subscriptions are automatically triggered, incoming payments are

monitored by Novalnet and the settlement of subscriptions with different maturities is possible.

The Novalnet offers you 2 variants of subscriptions:

Pre-defined subscription

With a pre-defined subscription, the desired subscription cycles with duration, amount and number of

repetitions are predetermined in the Novalnet administration under the PROJECTS tab, select desired

project and click Create new tariff under Shop Parameters. During the actual payment call, only these

settings are then referenced and the Novalnet system creates the subscription according to the settings.

The amount also has to be transferred to the payment call, since it is already deposited in the

subscription settings.

Figure 63

https://card.novalnet.de/

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





42

Dynamic subscription

For dynamic subscriptions, only the currency and the assignment to a product are stored in the Novalnet

administration portal. Amounts and subscription cycles are transferred dynamically during the payment

call, Novalnet then automatically creates the subscription according to the submitted specifications.

Figure 64

Note: For subscriptions, please deposit the respective tariff ID from the Novalnet-Adminportal in the

Magento shop-backend.

If you want to use dynamic subscriptions, navigate to Novalnet -> Configuration -> General in shop

backend. In the Subscription Tariff-ID drop-down list, select the tariff ID that you have previously

deposited in the Novalnet merchant portal. Additionally, enter a Period for subsequent subscription

cycle (1d = 1 day/1m = 1 month/1y = 1 year).

Figure 65

Field Description

Subscription Tariff ID This is the tariff ID which is used to process the subscription transaction with respective features

Period for subsequent subscription cycle The period of the subsequent subscription cycle. Period value has combined with d, m, y. If 1d means given subscription transaction process per day. If 1m means given subscription transaction process per month. If 1y means given subscription transaction process per year. Example: 2d

Recurring order

If you renew a subscription, a new order is created, specifying the parent tid of the "old" subscription.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





43

9.1 Suspending subscriptions

If you want to suspend a subscription (e.g. due to a financial bottleneck of the end customer), you can

suspend it under Novalnet -> Recurring Profiles.

Figure 66

Select the subscription you want to suspend.

Figure 67

Now click on Suspend.

Figure 68

As soon as a subscription is suspended, the status of the subscription changes to Suspended.

Figure 69

To re-enable an unsubscribed subscription, select Activate. The status then changes to Active.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





44

Figure 70

Suspend/Activate subscription by the buyer

The buyer has the possibility to suspend or reactivate subscriptions in your Magento webshop. To do so,

he can log in to his account and click on the respective order. The SUSPEND button can now suspend the

subscription.

Figure 71

The subscription status now changes immediately to Suspended.

Figure 72

Activation of the suspended subscription is also possible via the buyer account.

Figure 73

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





45

9.2 Cancel subscriptions

Termination of the shop backend

Please navigate to Novalnet -> Recurring Profilesto view the list of all subscriptions to your store. Select

the subscription you want to cancel, and then click Cancel option.

Figure 74

Now select a reason for the cancellation and confirm it by clicking on the Cancel button.

Figure 75

After successful cancellation, the status of the subscription changes to Canceled.

Figure 76

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





46

Termination by the Buyer

The buyer has the possibility to cancel a particular subscription in his customer account under Recurring

profiles. To do this, he logs into his customer account, selects the desired subscription, and clicks CANCEL.

Figure 77

Now the buyer can select a reason from the dropdown list and cancel the subscription by confirming the

CANCEL button.

Figure 78

After the successful termination, the status of the order changes to canceled. The end customer receives

a message that the status of the subscription has changed successfully.

Figure 79

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





47

For subsequent statistical evaluations, you can check the reasons for termination in the shop backend at

Novalnet -> Orders -> view the Canceled subscription in the payment Information field.

Figure 80

Note: To process all subscription functions successfully, please configure your server IP address in the

Novalnet administration portal. Under PROJECTS tab select desired Project and click Update Payment

Request IP under Project Overview tab.

Figure 81

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





48

10. Affiliate management system With the payment solutions offered by Novalnet, customers can order items from different retailers and

go through a single payment process even for mixed shopping baskets. In this process, the central

incoming payments are processed automatically and zag-compliant and forwarded to the respective

dealers. Through the integrated affiliate management (Marketplace) solution of Novalnet AG, the trader

as a platform operator can simultaneously handle up to four involved payees per transaction in an

amount. The payment call is then fully automated at Novalnet AG and split in real time to these four

payment recipients involved. In addition to this real-time splitting of the transaction, Novalnet AG also

offers the account management for the Partners (affiliate), including a transparent invoice creation,

fiduciary money management, payment, an extensive customer management, etc. To every payment

recipient of the trader of Novalnet AG who is involved can view all transactions in detail via the

Adminportal of Novalnet AG.

Through our Admin-Portal, you have the possibility to register one of your potential affiliates simply as a

partner via a link under PROJECTS -> select desired Project and click Affiliate Info.

Figure 82

You can now use the NETWORK tab to make the commission settings for the respective affiliates:

Pay per Lifetime: Recurring revenue share in %

Pay per Lead: Fixed amount per transaction

Figure 83

After you have set the commissions, click the Save button.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





49

11. Uninstalling the Novalnet payment extension You can uninstall the payment extension by removing the Novalnet files that you have stored in your

store root in point 3.3 plugin installation. After emptying the store cache, the Novalnet tab disappears

from your store backend.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





50

12. Imprint and contact

You can find the latest news about us on Twitter::

www.twitter.com/novalnet

Follow us on Facebook: www.facebook.com/novalnet

Link to Xing: www.xing.com/companies/novalnetag

If you have any inquiries, please contact one of the following departments:

Technical Support:

[email protected]

+49 89 9230683-19

General Reseller Support:

[email protected]

+49 89 9230683-21

Contact the sales team:

[email protected]

+49 89 9230683-18

http://www.twitter.com/novalnet

http://www.facebook.com/novalnet

http://www.xing.com/companies/novalnetag




Novalnet payment Module for Magento...Novalnet payment Module for Magento Compatible with the...

Documents

Transcript of Novalnet payment Module for Magento...Novalnet payment Module for Magento Compatible with the...