Go-live checklist

Test your checkout page

Make sure you have tested your checkout page thoroughly before going live. See the guides:

• Test enviroment
• Test card processing
• Test invoice processing

Verify webhook events

Webhooks are the most robust and efficient way of keeping your backend in sync with Checkout. It is robust against various runtime failures (network failures and other temporary processing failures) and efficient since it avoids polling Checkout for state changes.

Make sure that you receive the payment events that are relevant for your webshop. More information about webhooks can be found at the following pages:

• Track events using webhooks (guide)
• Webhooks (reference)

Secure your site (HTTPS)

Your webshop must use a secure connection over HTTPS in order to offer your customers a private and secure shopping experience.

Use the live APIs and JavaScript SDK

Make sure that the production environment of your webshop uses the live URLs to the following Checkout resources:

• The REST APIs (Payment API, Boarding API, and Reporting API). See the section Environment and base addresses in the API reference.
• The Checkout JS SDK (if you are using an embedded checkout page).

Use the integration keys for the live environment

Make sure that the production environment of your webshop uses the integration keys intended for the Checkout live environment. You can find the integration keys in the Portal. See also the guide Access your integration keys.

Include contact details

The contact details of your webshop should be clearly visible on your site and include the following:

• Name
• Address (including country)
• Email and/or telephone number to your support or service desk
• The shop’s Company registration number (CVR, Organisation number)

Include terms & conditions

Your webshop should provide a page that clearly states the terms and conditions when making purchases on your site. The page should include:

• Terms of sale and delivery, including the right to terminate the purchase agreement.
• Terms of consumers' right to cancel a purchase according to the distance and off premises act. This includes a cancellation period and terms for withdrawal.
• Description of the goods and services that your webshop is selling (including prices, taxes and fees)
• Clear shipping policies (by courier, post, traceable etc.) and expected delivery time.
• International shipping restrictions, if applicable.
• State which currencies you are using by currency code (SEK). E.g. "All prices are in SEK incl VAT"
• Information about how personal information is processed.
• Information about how card information is processed.

Include the Group logo on your website

As per our terms and conditions, the Nexi Group logo must be displayed to indicate that the payment solution is provided by Nexi Group. The logo has to be added either:

• To the checkout at the payment method selection stage.
• To the footer if you display available payment options in the footer.

You can find the Nexi Group logo’s specifications here Logo (nexigroup.com).

You can find the terms and conditions here Terms and conditions for Checkout (nets.eu)

Include payment method logos on your website

The following payment method logos have to be added to your website either:

• To the checkout at the payment method selection stage.
• To the footer if you display available payment options in the footer.

Below is an example of what the logos could look and be displayed as:

There are three different options on how you can easily compile the payment method logos applicable for your website:

Download the logos separately

You can check the links below from the list and download the logos separately here:

• Visa
• Mastercard
• Maestro
• Vipps
• Ratepay
• PayPal
• Dankort
• MobilePay
• Swish
• Apple Pay

HTML table

Alternatively, you can also check the specific logos of the payment methods that you provide by copying and pasting from the table in HTML from below. All logos are in .svg format and you can easily modify the sizes as well.

<table>
<tr>

<!-- NEXI CHECKOUT --> <td><img src="https://portal.dibspayment.eu/assets/images/main/easy-logo-blue_150px.svg" width="50"></td>

Make sure your VAT values are correct

When creating the payment object, please make sure, that the item's taxRate and taxAmount properties of your payment's order object are correct:

Also, the taxAmount must be correct, according to unitPrice and taxRate.

Neither the unitPrice nor the netTotalAmount should include the taxRate.

The grossTotalAmount must equal the sum of taxAmount and netTotalAmount per item.

Use decimal spaces in the correct way

Checkout will never round up or round down amounts by recalculating your data. We only send your requests to the required components with the data received from you. That is why it is very important for you to follow the instructions below.

Have in mind the following:

• Decimals are always specified as the lowest monetary unit for the given currency. It means that 1 EUR, for example, will have the lowest monetary unit of 1 cent, as there is no lower monetary unit than the cent.
• Checkout requires exactly two decimal spaces and rounding up or rounding down is not encouraged. With Checkout, it is possible to round up or round down, but it is not advisable as there are some payment methods that do not allow it, and in those cases, the payment will be disabled.
• If the amount specified does not contain any lowest monetary unit, then you need to add two zeros at the end to specify that no decimals are included. For example, entering the amount of 100 corresponds to 1 unit of the currency entered, such as e.g. 1 NOK.
• Amounts (even those with decimal spaces) are specified without punctuation marks. For example, 9.99 USD is specified as 999.
• When you send transaction details to Checkout, the details are processed without any recalculation, so there is no automatic rounding up or rounding down happening in that process.

Issues

• Sometimes it might happen that some plugins might round up or round down amounts and send them as such to Checkout. In this kind of scenario, some parameters might not match, so the payment process receives an error. That is why it is important to include 2 (two) decimal spaces for each amount, even if there is no lowest monetary unit present. For example:
  • in case of an amount without the lowest monetary unit: 19 EUR should be entered as 1900 (two zeros at the end represent that there are zero cents in the amount)
  • in case of an amount with the lowest monetary unit: 19,99 EUR should be entered as 1999 (the amount is entered with the decimals, but without the separator)
• Sometimes it might happen that a transition request is not accepted. That is due to different payment methods not accepting any rounding up or rounding down, so different parameters will not match as the round-up or the round-down amount will not be the same as the actual one, with decimals. To solve this, always use 2 (two) decimal spaces, without punctuation marks/decimal separators (comma or point).

Formulas for calculating tax, price, and the total amount

• netTotalAmount = unitPrice * quantity
• taxAmount = netTotalAmount * taxRate / 10000
• grossTotalAmount = netTotalAmount + taxAmount

Links and additional information

• For more information on each parameter, visit our API reference page.
• Here you can also read more on how to make sure your VAT values are correct.

Show order summary

Before the customer proceeds to the checkout page there should be a summary including the following:

• A complete description of the services/products included in the order. In other words, the customer must never doubt what he/she is paying for.
• A clear itemization of the total amount being charged including shipping, value added tax, etc.
• It must be clear to the consumer what currency is applied for the transaction. If you offer international shipping, please state the currency code in the order summary also. (SEK)
• Clarification that the consumer can pay by card.
• Inform your customer that the invoice will be sent via email.

Send order confirmation

Once a purchase is completed, the customer must receive a confirmation of the order and a receipt in the form of an email.

See the guide Confirm order for information about the requirements of the order confirmation.