Installation guide - Novalnet payment plugin for …...Novalnet Payment Plugin for PrestaShop...
Transcript of Installation guide - Novalnet payment plugin for …...Novalnet Payment Plugin for PrestaShop...
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
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
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
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
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
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
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
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
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
E-Mail: [email protected]
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Click on Save button to update/save the changes made.
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
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
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:
• None (select shopping type)
• One click shopping
• Zero amount booking
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
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
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.
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.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
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.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
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
17
4.4.5 PayPal
Field Description
Shopping type
You can select one of the following options here:
• None (select shopping type)
• One click shopping
• Zero amount booking
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. 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
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
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
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
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
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
20
Click on Save button to update/save the changes made.
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
The changes you made are now visible in the Messages Meta Box.
Figure 38
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
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
The changes you made are now visible in the Messages Meta Box.
Figure 40
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
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
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
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
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
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
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
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
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
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.
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
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
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
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
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
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
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
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
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
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
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
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:
+49 89 9230683-19
General Reseller Support:
+49 89 9230683-21
Contact the sales team:
+49 89 9230683-18