Nets

Features

• Credit/Debit cards
• Bank Direct payments
• Multi-market support
• More information: www.nets.eu

Before you begin, contact Nets at www.nets.eu and obtain the test account. Your merchant should apply for production accounts separately.

You will get following information

1. User Id and password to their Admin site
   1. https://epayment-test.bbs.no/admin/Default.aspx (test)
   2. https://epayment.bbs.no/admin/Default.aspx (production)
2. Merchant Id
3. API token

Install

Read the system requirements for development environment before installing

Follow the steps below:

1. If already exists back up Litium.Studio.AddOns.Nets.dll.config file from wwwroot
2. Open Visual Studio and your solution
3. Open Package Manager Console that is found in Tools > NuGet Package Manager menu. If multiple projects exists in the solution ensure that the web application project is selected as Default project in Package Manager Console.
4. Install nuget-packages with the command in Package Manager Console

   Install-Package Litium.Studio.AddOns.Nets
   Install-Package Litium.Studio.AddOns.Nets.UI

5. Update the Litium.Studio.AddOns.Nets.dll.config found in wwwroot and fill it with configuration options

Configure Litium.Studio.AddOns.Nets.dll.config

To configure Nets, you should edit the file Litium.Studio.AddOns.Nets.dll.config in your web\bin directory.
If the file doesn't exists, then rename the file with similar name as above, but ends with "dll.config.tmpl.exclude" to above name.

Necessary configuration instructions are at the begining of this file.

Configuring transaction callback

Nets can call Litium Studio to notify changes to the transaction status. This notification call back is important in bank direct payments.

To setup, login to nets admin backoffice, and go to Options > Callback

Enter following url as the callback url.

https://<your site domain name>/PaymentProviderResult.axd/Report/Nets?paymentAccIdentifier=<Your payment account identifier in config file>

e.g.: https://paymentproviders-47.product.workplace.nu/PaymentProviderResult.axd/Report/Nets?paymentAccIdentifier=SE

In above example, the site domain name is "paymentproviders-47.product.workplace.nu", and the Litium.Studio.AddOns.Nets.dll.config contains the paymentAccIdentifier as "SE" for the Nets account.

Nets mobile package

Nets payment user interface can be adopted to mobile devices, but it requires Nets to configure the merchant account with "MobilePackage". In the project one can set to use the mobile package always by setting the 'useMobilePackage' attribute in the addons config file to true. This will make even desktop users go to mobile payment page which might not be appropriate.

To have a more adaptive behaviour, set the 'useMobilePackage' parameter to 'false' in the Litium.Studio.AddOns.Nets.dll.config and then change the CheckoutFlow page type template to detect the users browser and determine whether it is a mobile device or not. If it is a mobile device, set the checkoutflowInfo setting key NetsExecutePaymentArgs.CheckoutFlowInfoKeyMobileDevice to true.

Following code fragment shows how it will look if you change the accelerator checkout template.

              var ismobileDevice = false;

                //TODO: implement the method DetectMobileDevice() to determine whether the users browser is a mobile device or not., and uncomment the line below.
                //ismobileDevice = DetectMobileDevice();

                CurrentState.Current.ShoppingCart.CheckoutFlowInfo.SetValue<bool>(Litium.Studio.AddOns.Nets.NetsExecutePaymentArgs.CheckoutFlowInfoKeyMobileDevice, ismobileDevice);

                ExecutePaymentResult result = paymentInfo.ExecutePayment(CurrentState.Current.ShoppingCart.CheckoutFlowInfo, CurrentState.Current.Token);
                if (result != null)
                {
                    HandlePaymentResult(result.Success, result.ErrorMessage);
                }

Testing Nets

If you do not have a test account to exclusively test Nets, you should request a seperate test account to be used from your staging environments.

Test information is at: http://www.betalingsterminal.no/Netthandel-forside/Teknisk-veiledning/Test-cards/