NETS

This page provides an overview of the payments methods provided by the NETS adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating NETS within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment Method	TransactionFlows	Transaction Types
Visa	Full-Page Redirect & Widget - payment-widget.js	All
Mastercard	Full-Page Redirect & Widget - payment-widget.js	All
Direct Debit	Full-Page Redirect & Widget - payment-widget.js	All
Swish	Full-Page Redirect & Widget - payment-widget.js	Debit, Preauthorize, Capture, Refund, Void, Register
Vipps	Full-Page Redirect & Widget - payment-widget.js	Debit, Preauthorize, Capture, Refund, Void
Sofort	Full-Page Redirect & Widget - payment-widget.js	Debit, Preauthorize, Capture, Refund, Void
MobilePay	Full-Page Redirect & Widget - payment-widget.js	Debit, Preauthorize, Capture, Refund, Void
ArvatoAfterPay	Full-Page Redirect & Widget - payment-widget.js	Debit, Preauthorize, Capture, Refund, Void

Additional Parameters

Name	Type	Required	Description
description	string	true	Transaction description.
extraData.embeddedCheckout	boolean	false	Indicates if the embedded checkout via widget, or the full page redirect should be used.
extraData.termsUrl	string	true	The URL to the terms and conditions of the web shop.
extraData.checkoutUrl	string	false	URL of the page where the embedded checkout widget should be shown. Should be empty if the HPP is used.
extraData.merchantHandlesConsumerData	boolean	false	Indicates if the customer data form will be shown on the checkout page.
extraData.customerType	string	false	Type of the customer. Allowed values are B2B or B2C.
extraData.language	string	false	Specifies the preferred language for the checkout process, enhancing localization and user experience.
customer.shippingCountry	string	true	The customers shipping country.
customer.identification	string	false	The customer identification on the web shop side.
customer.email	string	false	The customers email.
customer.shippingAddress1	string	false*	The customers shipping address line 1.
customer.shippingAddress2	string	false	The customers shipping address line 2.
customer.shippingPostcode	string	false	The customers shipping post code.
customer.shippingCity	string	false*	The customers shipping city.
customer.shippingFirstName	string	false	The customers first name.
customer.shippingLastName	string	false	The customers last name.
customer.shippingCompany	string	false	Company name.

note

If the merchantHandlesConsumerData parameter/setting is set and any of the shipping address parameters are set, the parameters customer.shippingAddress1 and customer.shippingCity are required.

Item Parameters

Name	Type	Required	Description
item.identification	string	true	Item identification of the web shop.
item.name	string	true	Item name
item.quantity	integer	true	Item quantity
item.extraData.unit	string	true	Unit used for the items. E.g. pcs.
item.price	float	true	Price for each item unit
item.extraData.netTotalAmount	float	true	Total price for the items excluding VAT. item.price * item.quantity
item.extraData.grossTotalAmount	float	true	Total price for the items including VAT. item.extraData.netTotalAmount + item.extraData.taxAmount
item.extraData.taxAmount	float	false	Tax amount for the items. item.price * item.quanity * item.extraData.taxRate / 10000
item.extraData.taxRate	float	false	Tax rate used for the tax amount. The tax rate should be provided in percentage times 100. E.g. 25% tax rate as 2500

note

If no items are provided, items will be build with the description field as item identification and name.

note

The grossTotalAmount of all items have to match the transaction amount.

Config Parameters

Name	Type	Required	Description
API Secret	string	true	The API Secret provided by NETS.
checkoutKey	string	true	The checkout key used for the payment widget. Provided by NETS.
webhookAuthorization	string	true	Any string chosen by you. Will be used to authorize webhooks from NETS.
currencyForVerify	string	true	currency used for verify calls.
embeddedCheckout	string	false	See extraData.embeddedCheckout
merchantHandlesConsumerData	boolean	false	See extraData.merchantHandlesConsumerData.
paymentButtonText	string	false	Text used for the payment button on the checkout page.
showMerchantName	boolean	false	Indicates if the merchant name (in the NETS account) should be shown on the checkout page.
showOrderSummary	boolean	false	Indicates if the order summary should be shown on the checkout page.

note

Following config parameters are only used for the payment widget for the embedded checkout.

Name	Type	Required	Description
backgroundColor	string	false	Hex color code for the payment widget background color.
panelColor	string	false	Hex color code for the payment widget panel color.
textColor	string	false	Hex color code for the payment widget text color.
primaryColor	string	false	Hex color code for the payment button color in the payment widget.
linkColor	string	false	Hex color code for the payment widget link color.
placeholderColor	string	false	Hex color code for the payment widget input field placeholders.
outlineColor	string	false	Hex color code for the payment widget outlines.
primaryOutlineColor	string	false	Hex color code for the payment button outline color in the payment widget.
panelTextColor	string	false	Hex color code for the payment widget panel text.
panelLinkColor	string	false	Hex color code for the payment widget panel links.
buttonTextColor	string	false	Hex color code for the payment widget panel button texts.