Install

1. Download

Download the ZenCart file from Downloads.

2. Move the files

Move the files with a FTP program where your ZenCart store is located. The Zip-file is build in a way that you can move the ”includes” and ”images” folders to corresponding folder on the server and press replace all files and the files will go to the right place. This action does not affect any other files, except Klarna's files*. NB! If you have made changes in the file structure of your ZenCart store, it is not sure that all the files will fall into the right place since they are based on the standard structure.

*If you already have files from Klarna, they will be overwritten. All properties will be saved though since they are in the database.

Settings

You find Klarna payment modules in the admin-part in modules → payment. Please note that all countries have their own payment module.

Invoice

The invoicing module is called invoice through Klarna in the local language. There you will find the following properties:

”Merchant ID” is the Estore ID that you have received from Klarna. "Product artno attribute indicates what will be shown in the article number field in the invoice. ”Id” means that there will be a number and ”model” means that the product model will show. ”Enable Auto Activate” is a service where Klarna activates the invoice as fast as the purchase is made and approved and also sends out the invoice to the customer. This service can't be used without Klarnas approval and activation. "Activate delay" means that if you use auto activation, how many days after the order has been made that the invoice is activated. ”Pre-populate personnumer field” indicates if the module should try to fill out the social security number field from the database. If you do not have this information in the store, it is better to set this to ”false”. ”Credit limit” decides to which orders Klarnas service will be shown as an option. If the order is not over the configured value, Klarnas payment module will show. Please note that this is based on the value in the basket, which does not include invoice and shipping fees. Value is given in ören. The credit limit is something that the store has agreed on with Klarna and Klarna will not accept any purchases that is over the agreed limit regardless what is set in this value. This limit is only for the customer to not be able to make purchases over this limit and receive and error message. ”Ignore table” is a list of modules in ”order total” that does not generate any new costs or discounts. These will not show in the invoice. By default, ot_tax, ot_total and ot_subtotal are ignored since they do not add any new costs/discounts. ”Payment Zone” can be configures to limit in which zone the payment module is available. Please note that the specific modules for each country only accept corresponding country, language and currency e.g. Denmark, danish and Danish krona. ”Tax Class” is used for these additional fees. It is not used to how much tax is added, but how much of the fee is tax. ”Sort order of Display”-value decides in which order the modules are shown in the checkout, 0 = first.

part payment

The part payment module is called part payment from Klarna (this module is not available for Norway yet).

”Set pclass” indicated the numbers that you find in Klarna Online in the menu ”Display store” and ”Click here to show campaigns”. ”Set month” describes the amount of months the pclass values above have. It means that all the information must come in the same order as in ”Set pclass”. ”Set monthly fee” is the monthly invoice fee that Klarna charges. ”Set rate” indicates the interest rate for every pclass value. ”Set start rate” indicates the starting fee for the pclass values.

Invoice fee

If you want to charge an invoice fee, you can configure this in ”Modules → Order Total”. You can either have a fixed invoice fee or different fees depending on the size of the order. Do not forget to set the correct tax for the invoice fee with the help of tax class. It is important to update ”Sort order” to a value that is lower than ”Total”, otherwise the invoice fee will not show in the order total but added.

Terms of payment is a text that will show as the payment terms text and which is linked directly to Klarna's payment terms. Extra info text is shown next to the invoice logotype.

Testing

You can make test purchases with our test persons

You can find an overview of all our test persons here

Denmark

Social security number: 0505610059
Name: Rasmus Jens-Peter Lybert
Address: Godthåbvej 8,-2
3900 Godthåb

Company registration number: 27968880
Company name: Onbase ApS
Address: Centrumgaden 37
2750 Ballerup

Norway

Social security number: 18106500157
Name: Petter Testmann
Address: Hundremeterskogen 100
0563 Oslo

Invoice number

When an invoice purchase has been accepted by Klarna, a referens number is created. This referens number is saved in the order history. It can look like

Customer
Date Added	Notified	Status	Comments
04/03/2005 20:29:52	True	Pending
04/03/2005 20:29:52	False	Pending	Accepted by Klarna
2005-04-03 20:29:52	Invoice #: 50504126710

Now you are ready to start using Klarnas services.

Do not forget to exit the test mode in Klarna Online when you are ready!