Plugin Installation

Required Actions Prior to Installation:

• Log in to the Novalnet Admin Portal.
• Log in to your WooCommerce Shop System.
• Make sure that you have extracted the payment plugin package from the zip file you have received. If you have received only the installation guide without the payment plugin package (zip file), please send us a mail to technic@novalnet.de with your merchant ID
• Ensure that you have created Access Keys for your account. If not, click on Create a New Access Key to generate them. For more details, refer here.

Installation

To install the Novalnet Payment Plugin, please go to your shop system and follow the steps below.

Step 1: Navigate to Plugins -> Add New in your shop admin panel.

Step 2: Next to Add Plugins, click Upload Plugin.

Step 3: In the next window that appears, click Choose File and choose the file woocommerce-novalnet-gateway.zip included in the Novalnet Woocommerce plugin package. Click Install Now to upload it into your shop system.

Step 4: After the installation, click Activate Plugin.

Upgrading the Novalnet Payment Plugin

Follow the below steps to update the latest Novalnet payment plugin - WooCommerce via shop admin panel.

Step 1: Navigate to Plugins -> Installed Plugins in your shop admin panel.

Step 2: Under the Novalnet payment plugin -> WooCommerce, click update now.

Now, updated version of Novalnet payment plugin -> WooCommerce will be displayed as shown below

Step 3: After installing (or) up-grading Novalnet payment plugin - WooCommerce and click Configuration as shown below

Refer section Global Configuration in the WooCommerce shop system to configure your Novalnet merchant account details.

Global Configuration in the WooCommerce shop system

The main configuration occurs in your WooCommerce shop system as well as in the Novalnet Admin Portal.

In your WooCommerce shop system navigate to WooCommerce -> Settings -> Novalnet Global Configuration. Enter the following keys as shown below:

• Product activation key - a unique token for merchant authentication and payment processing.
• Payment access key - a secret key assigned to each merchant which encrypts the data to avoid user manipulation and fraud.
• Tariff ID - a unique identifier created based on the tariff type at Novalnet.

To get your Product activation key and Payment access key, go to the Novalnet Admin Portal , navigate to Projects menu and click icon on the right of your project to view the project details

Click API credentials, copy the API Signature (Product activation key) and Payment access key. Create a Tariff ID for each tariff type for the webshop.

Paste the Product activation key and Payment access key in the respective fields in your shop system. Next, choose the Tariff ID from the drop down menu that you have created in the Novalnet Admin Portal for this WooCommerce shop system.

Then click Save Changes to update the changes.

Notification/Webhook configuration

In the Novalnet Global Configuration page on your shop system you will find your Notification / Webhook URL under Notification / Webhook URL Setup.

Click Configure to setup your Notification / Webhook URL in the Novalnet Admin Portal.

After successful configuration, your shop Webhook URL will be linked with your Novalnet Merchant account which can be seen under Vendor script URL/ Notification & Webhook URL field under API credentials of your project.

In your shop system, you can additionally test the Webhook URL manually and send notification emails to specific email addresses.

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

Client key configuration in the Novalnet Admin Portal

The client key is a unique key which is linked with your Novalnet merchant account to authenticate your client based requests. You need the client key to render the secure payment form and tokenize (temporarily) the sensitive information.

Step 1: Go to the Novalnet Admin Portal with your Novalnet merchant account details.

Step 2: Navigate to the Projects menu and choose your project.

Step 3: On the project details page click API credentials and click edit icon beside Allowed Domain(s).

Step 4: Paste your website URL in the Domain name field and click + Add.

Step 5: After adding the Domain name, they are listed under Allowed Domain(s).

Payment Activation in the Novalnet Admin Portal

All the Novalnet supported payment methods can be viewed here: www.novalnet.com/payment if you have questions about the payment methods or for additional payment method requests, please contact our sales team.

To activate the preferred payment methods for your website, navigate to Novalnet Admin Portal -> Projects -> Choose your project -> Payment Methods -> click Edit Payment Methods in the top right corner.

Next, select the preferred payment methods.

To use the Apple Pay payment method, go to Apple Pay -> Configure -> Add new domain in the Novalnet Admin Portal.

Then, paste your shop domain for which you enable Apple Pay, and click Download verification file. You will need to host that verification file in your domain's root directory.

For example: the path should be, https://woocommerce.novalnet.de/.well-known/apple-developer-merchantid-domain-association

To use the PayPal payment method, configure the PayPal API details in Novalnet Admin Portal.

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

Payment Configuration in the WooCommerce shop system

Soon after the activation of the payment methods in the Novalnet Admin Portal, you must enable these payment methods in your shop system to display them on your WooCommerce checkout page. Navigate to WooCommerce -> Settings.

In the settings page, click Payments tab.

Click Enabled to activate the preferred payment methods.

Uninstallation

To uninstall the Novalnet Payment Plugin, please follow the steps below.

Step 1: Navigate to Plugins -> Installed Plugins.

Step 2: Under the plugin Novalnet payment plugin - WooCommerce, click Deactivate.

Step 3: After deactivating, click Delete.

Step 4: Click OK to confirm that you wish to uninstall and delete the Novalnet payment plugin permanently from your shop system.