Installation guide - Novalnet payment plugin for …...Novalnet Payment Plugin for PrestaShop Compatible with Prestashop versions 1.7.0.5 – 1.7.5.1 Installation Instructions 4 NOVALNET

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 Plugin for PrestaShop Compatible with Prestashop versions 1.7.0.5 – 1.7.5.1

Installation Instructions

Ve

rsio

n 1

1.2

.4

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.3 Module installation .................................................................................................................. 8

4. Settings ........................................................................................................................................... 10

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

4.1.1 IP address for payment calls .............................................................................................. 10

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

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

4.2 Settings in the shop backend ................................................................................................. 11

4.3 Configuring the payment methods ....................................................................................... 14

4.4 Special settings for payment methods .................................................................................. 15

4.4.1 Credit Card .......................................................................................................................... 15

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

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

4.4.4 Prepayment ........................................................................................................................ 16

4.4.5 PayPal .................................................................................................................................. 17

4.4.6 Barzahlen ............................................................................................................................ 17

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

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





3

4.5.1 Force 3D secure .................................................................................................................. 18

4.5.2 PIN by callback & PIN by SMS ............................................................................................ 19

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

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

4.8 Individual order status management .................................................................................... 22

5. Orders ............................................................................................................................................. 24

5.1 Order overview ....................................................................................................................... 24

5.2 Order details ........................................................................................................................... 24

6. Follow-Up transaction process ...................................................................................................... 25

6.1 Confirm/Cancel a transaction ................................................................................................ 25

6.2 Transaction refund process ................................................................................................... 26

6.3 Changing the amount of an order ......................................................................................... 27

6.4 Order Due date update .......................................................................................................... 28

6.5 Change the expiration date of the payment slip (cash) ....................................................... 29

7. Payment Reference ........................................................................................................................ 30

8. Shopping type ................................................................................................................................ 31

8.1 One click shopping ................................................................................................................. 31

8.2 Zero amount booking ............................................................................................................. 32

9. Subscriptions .................................................................................................................................. 34

9.1 Cancel subscriptions ............................................................................................................... 36

9.2 Cancel subscriptions (Webshop) ........................................................................................... 37

10. Affiliate system management .................................................................................................... 38

11. Uninstalling ................................................................................................................................. 39

11.1 Uninstalling the Novalnet payment plugin ............................................................................... 39

12. Imprint and contact ................................................................................................................... 40

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.2.4 [Enhanced] Guaranteed payment pending status has been implemented [Enhanced] Callback has been optimized as per the new testcase

05-10-2018

11.2.3

[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] 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 IP condition check for remote address

31-01-2018

11.2.2 [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

22-11-2017

11.2.1

[New] Implemented Barzahlen payment method [Enhanced] Optimized vendor script validation [Removed] Refund with account details from shop admin [Removed] Enable debug mode configuration in Merchant script management [Compatible] Checked for Prestashop version upto 1.7.2.4

14-09-2017

11.2.0 New release 29-07-2017

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 plugin for

Prestashop system.

Contact

Novalnet AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Website: https://www.novalnet.com

Tel.: +49 89 92 30 683 - 19

Fax: +49 89 92 30 683 - 11


https://www.novalnet.com/

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

Prestashop

Version: 1.7.0.5 - 1.7.5.1

Novalnet Requirements

Novalnet merchant account

Novalnet payment plugin for Prestashop

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.

3.2 Download

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

Link: https://www.novalnet.com/modul/prestashop-payment-module

Figure 1


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

https://www.novalnet.com/modul/prestashop-payment-module

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

3.3 Module installation

To upload the Novalnet payment module, go to Modules -> Modules & Services (on left side of the

navigation bar) from admin end.

Figure 3

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





9

Click on button.select the Novalnet payment module novalnet.zip to proceed installation.

Figure 4

Once the module gets installed successfully, it will be displayed as shown below.

Figure 5

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





10

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 6

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 marchant 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 Prameters tab, copy the activation key to store it as shown in Figure 11 in the shop

backend.

4.1.3 PayPal API-configuration in Novalnet administration portal

If you want to use PayPal as a payment method, log in to the Novalnet-Adminportal under

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

Methods, select PayPal and click Configure.

Figure 7

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





11

Enter your PayPal API data here and click on Update.

Figure 8

4.2 Settings in the shop backend

API (Activation key of your project)

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

ID, Authentication code, Payment access key, Project ID and Tariff ID) of your marchant accounts in the

shop backend. This can be found in the Novalnet administration portal. Click on the Modules, select your

project, under the Shop Prameters.

Once installed, the Novalnet payment module will be

available in the menu Modules -> Modules & Services. Click on CONFIGURE button of Novalnet

payment module to configure the same.

Figure 9

Go to Modules -> Modules & Services using admin login in the shop back-end, click on CONFIGURE

button of Novalnet payment module then click on the NOVALNET GLOBAL CONFIGURATION tab.

Figure 10

Product activation key

To configure the merchant details, enter the given activation key in the Product activation key field. 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.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





12

Once the activation key is entered in the Product activation key field, all basic configuration details will be filled automatically.

Figure 11

Tariff ID

Tariff ID can be configured based on the merchant’s requirement.

Figure 12

Click on Save button to update/save the changes made.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





13

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 marchant 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.

Debug log Log the Novalnet payment events in the shop.

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.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





14

4.3 Configuring the payment methods

This overview, shows all the Novalnet payment methods. Select the respective payment from the list.

Figure 13

Set the Enable payment method field as True, to display the payment in the web shop. Kindly, configure

other fields based on the needs

Figure 14


Note: Save your settings separately for each payment.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





15

4.4 Special settings for payment methods

Configurable in Modules -> Modules & Services -> Novalnet payment

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.

Shopping type You can select one of the following options here:

• None (select shopping type)

• One click shopping

• Zero amount booking

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.

Display AMEX logo

If you activate this option, you accept payments via Amex credit card. An

Amex business case must be available for this. The Amex logo will also

appear on the checkout page.

Display Maestro logo

If you activate this option, you accept payments via Maestro credit card.

For this, Novalnet Maestro business case must be available. The Maestro

logo will also appear on the checkout page.

Display CartaSi logo

If you activate this option, you accept payments via Cartasi credit card. A

Cartasi business case must be available for this. The Cartasi logo will also

appear on the checkout page.

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).

Shopping type You can select one of the following options here:




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.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





16

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).

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.3.2 Direct Debit SEPA -> Enable 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.


NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





17

4.4.5 PayPal

Field Description

Shopping type

You can select one of the following options here:





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.

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 15

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

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





18

Figure 16

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.

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.


NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





19

Go to Modules -> Modules & Services -> Novalnet payment -> Credit Card in the shop admin panel, to

enable the Credit Card Force 3D secure on predefined conditions.

Figure 17

Figure 18

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 Select the fraud prevention (PIN by

callback) in the Enable fraud prevention option.

The activation in the shop backend can be made under the settings of the payment types Direct Debit

SEPA and Invoice. After activating the fraud check, entr Minimum value of goods for the fraud module (in

minimum unit of currency. E.g. enter 100 which is equal to 1.00) and save your configuration.

The integrated fraud modules will be available in the payment configuration as mentioned below.

Figure 19

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





20


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.

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 20

Note: Please configure the IP address of your server in the Novalnet administration portal.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





21

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 21

Vendor script URL

URL: <URL of your shop>/NovalPayment/status

e.g.: https://Prestashop.novalnet.de/NovalPayment/status

Figure 22

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.5 Merchant script configuration in Novalnet admin portal). You can find the Merchant script

management under NOVALNET GLOBAL CONFIGURATION.

Figure 23

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





22

Click on the Save button to update/save the changes made.

Field Description

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).

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.

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

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

Notification URL Notification URL is used to keep your database/system actual and

synchronizes with the Novalnet transaction status.

4.8 Individual order status management

To set the order status, go to Modules -> Modules & Services, click on CONFIGURE link of Novalnet

payment module and select the required payment method.

Order Completion 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 24

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 25

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 26

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





23

On-Hold Bookings

An on-hold booking will leave the order in the waiting mode (max. Up to 14 days) until you confirm or

reject it yourself. In our payment module for Prestashop you have the option of setting the limit for on-

hold bookings in the basic settings, to suspend transactions from a certain amount until you manually

reject them or confirm them.

To set the status for On-hold transactions (assuming a limit for on-hold transactions has been set),

navigate to control the status of the payment for on_hold transactions. Here you can set the status for

confirmed and canceled payments here.

Figure 27

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





24

5. Orders To view the Novalnet orders, click on the Orders sub menu (on left side of the navigation bar) via Orders main menu.

Figure 28

5.1 Order overview

Now, click on View button to view the order details.

Figure 29

5.2 Order details

Now, you can review the order details of the respective order information under MESSAGES meta box.

Figure 30

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





25

6. Follow-Up transaction process

6.1 Confirm/Cancel a transaction

To confirm or cancel an on-hold payment, click on the respective order. You can now use the drop-down

list to confirm/cancel the order from Orders -> Orders in the admin end to view the order details.

In the MANAGE TRANSACTION PROCESS meta box, click on CONFIRM/CANCEL button to confirm or

cancel the transaction of the respective order.

Figure 31

Once the order has been confirmed or canceled successfully, the transaction details will be displayed in

the MESSAGES meta box of the particular order.

Figure 32

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





26

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 and navigate to the Refund field of the transaction. Enter the

required refund amount (in minimum unit of currency. E.g. 500 = €5.00) in the corresponding field. Click

the Confirm button to refund the amount you entered.

Figure 33

A refund is also displayed in the Messages Meta Box.

Figure 34

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

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

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





27

6.3 Changing the amount of an order

You have the option to change the amount of an order with purchase orders on invoice, prepayment,

Sepa Direct debit and cash. Select the relevant purchase order and navigate to the Change the amount/

due date field. You can change the amount of the selected purchase order here. Enter the valid amount

(in the minimum unit of currency, e.g. 3000 = €30.00) in the appropriate box, click the Update button and

confirm the change.

Figure 35

The changes you made are now visible in the Messages Meta Box.

Figure 36

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





28

6.4 Order Due date update

For orders with purchase on account and in advance you have the possibility to change the payment

target of an order. Select the relevant purchase order and navigate to the Change amount/ due date

field. If you want to change the payment destination, click the calendar in the Due Date field of the

transaction. From the pop-up calendar, select a desired date from the future, click the Update button,

and confirm change.

Figure 37


Figure 38

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





29

6.5 Change the expiration date of the payment slip (cash)

In the case of the cash payment method, your customer has 14 days by default to pay for a cash partner

branch. To change the validity period of a payment slip, select the relevant order. Under the Change the

amount/slip expiry date field of the payment slip, you can now select any date from the calendar where

you want the payment slip to expire for the order you want. Click Update and confirm to make the

change.

Figure 39


Figure 40

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





30

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

activate/deactivate the settings under Modules -> Modules & Services click on CONFIGURE link of

Novalnet payment types.

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

If No, the relevant data will not be displayed on the end customer's invoice.

Figure 41

e.g. 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 Messages Meta Box of the particular order.

Figure 42

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





31

8. Shopping type For the following payment types, we have integrated shopping types with One click shopping and Zero

amount Booking

Credit Card

Direct Debit SEPA

PayPal

8.1 One click shopping

One click Purchase allows registered customers to make an online payment with one click by using the

Payment account details or card information from previous orders.

Figure 43

Credit Card / Direct Debit SEPA / PayPal

After a successful order the payment method, for example SEPA Direct debit is automatically selected

with the previously specified pay data as a pay type. Thus, the buyer can order with a click of payment. If

the buyer wishes to change the payment method, he can do so on the checkout page.

Figure 44

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





32

Change payment

In the event that the buyer wishes to change the payment method and has clicked on the Change button,

all payment methods provided in your shop will be available for you to choose from. Here the end

customer also has the possibility to enter new account data for the payment type SEPA direct debit.

If he wants to use his previous account data e.g. for SEPA Direct Debit, he can access it by clicking on the

Given account details.

This will look like the following:

Figure 45

8.2 Zero amount booking

In this process, the payment will be processed with amount value as zero. Once the order has been placed successfully, the merchant has to book the order amount to complete the transaction.

To proceed with zero amount booking, select the Zero amount booking from the drop down of Shopping

type field and click on Save button to update/save the changes made

Figure 46

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





33

After placing the order with zero amount booking, select the order in shop and enter the valid amount (in minimum unit of currency. E.g. enter 100 which is equal to 1.00) in the appropriate box, and click on the BOOK button to book the specified amount.

Figure 47

You can now see the amount charge you have made under the Communication tab in the Messages meta

box.

Figure 48

Note: Zero amount booking is not performed for subscriptions.

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





34

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 49

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.

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





35

Figure 50

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

Prestashop-backend. If you want to use dynamic subscriptions, go to the shop backend under Modules -> Modules & Services and now configure the empty fields.

Figure 51

Field Description

Enable subscription Enable (or) disable the subscription transaction process.

Subscription payments Select the subscription supported payments.

Subscription Tariff ID The tariff ID that you have deposited in the Novalnet dealer Portal

Dynamic subscription

Pre-defined subscription

Recurring order

When a subscription is renewed, a new order is created specifying the parent TID of the "old"

subscription.

Figure 52

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





36

9.1 Cancel subscriptions

In the order history, select the subscription you want and click the Cancel Subscription tab

. Figure 53

Select a reason for cancellation from the drop-down list, and then click Confirm.

Figure 54

For subsequent statistical evaluations, you can view the reasons for termination of the cancelled order in

the shop backend under the Messages meta box.

Figure 55

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





37

9.2 Cancel subscriptions (Webshop)

Your customer also has the possibility to cancel the subscription. To do this, logs into customer account in

web shop. Now selects the respective subscription from customer history and navigates to the Cancel

subscription field.

Your customer also has the option of selecting the reason for cancellation.

Figure 56

As soon as they have selected the reason for cancellation and confirmed their plan, the existing

subscription is canceled.

Figure 57

Note: To process all subscription functions successfully, you must configure your server IP address.

Address in the Novalnet administration portal under PROJECTS -> Select project -> Project overview ->

Last Point IPs for payment calls.

Figure 58

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





38

10. Affiliate system management 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 tab select desired Project and click Affiliate Info.

Figure 59

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 60

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





39

11. Uninstalling

11.1 Uninstalling the Novalnet payment plugin

Navigate to Modules -> Modules & Services.

Figure 61

Now, click on the YES, UNINSTALL IT button to uninstall the Novalnet payment module from web shop.

Figure 62

NOVALNET AG

Payment Institution

Gutenbergstr. 2

D-85737 Ismaning

Tel.: +49 89 9230683-19

Fax: +49 89 9230683-11


Tax id: DE254954139





40

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




Documents

Installation guide - Novalnet payment plugin for …...Novalnet Payment Plugin for PrestaShop Compatible with Prestashop versions 1.7.0.5 – 1.7.5.1 Installation Instructions 4 NOVALNET