Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

 
 
 
Virtuemart 2.x | Integration guide 
Klarna Checkout 
Documentation and Installation 
Version 1.0 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 
 
 
 
 
 
 
 
 
 

Table of Contents 
 
Klarna Introduction 
Glossary 
Step­by­step integration 
Installation 
Configuration 
Settings in Virtuemart 
Round only display 
One Page Checkout 
Discounts 
Testing 
Purchase phase 
Post purchase phase 
Other order management actions 
Going live 
Branding 
Troubleshooting 
Errors 
Orders 
FAQ 
Contact information 
 
 

 
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Klarna Introduction 
Klarna is the Nordic region’s most popular payment method, with the payment solution Klarna 
Checkout available in Sweden, Norway and Finland ­ allowing merchants to provide their end 
customers with several payment methods from only one payment provider. Klarna Checkout 
offers payment methods such as invoice, part payment, credit card and direct bank transfer.  
 
Klarna Checkout allows you as a merchant to increase your sales by offering your customers 
several payment methods. In an agreement with Klarna, we will also take the risk, where you as 
a merchant always get paid. 
 
This integration has been developed through a partner agreement between Klarna and 
Virtuemart.  
Issues or questions related to payment processes, order handling or administrational tasks in 
our web interface Klarna Online are owned by Klarna.  
Technical issues occurring in the payment gateway in Virtuemart, are handled by Virtuemart with 
guidelines provided by Klarna. If you are unsure about the issues that you encounter, contact 
your Klarna Integration department.  
 

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Glossary 
● Klarna Checkout: Klarna Checkout payment solution which includes incremental 
identification, buying process and paying process. 
● API­function calls: Direct communication between two systems. 
● Reservation number/reservation: When a purchase is approved the purchase amount 
is temporarily reserved from the customer’s credit limit. A reservation number is a key to 
the reservation and it is used to make changes to and activate the reservation. 
● Activation of reservation: Activates the reservation to a transaction in Klarna Online. At 
the same time, the credit time for the invoice purchases will start and payout towards the 
merchant will be initiated as well. A purchase notification will be sent out by Klarna via 
email. The reservation should be activated when the goods is sent to the consumer. 
● Transaction ID: The payment reference that is provided when a reservation is activated 
in Klarna. 
● Klarna Online: Klarna’s order handling system. 
● Website: The visible/public part of the webshop. 
● ERP: Business systems that handle orders after the customer has ordered through the 
Website. 
● EID: E­store ID, an ID provided to a merchant to act as the technical hook to Klarna’s 
systems.  

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Step­by­step integration
Installation 
1. Log in to your administration interface of Virtuemart 
2. Proceed to “Components” > “Virtuemart” > “Shop” > “Payment Methods” 
3. Add a new payment method by pressing “New” in the right section 
4. Enter your settings in the fields of ‘Payment Method Information’ 
 
 
Field  Explanation 

Payment name  The name of the payment method. Our suggestion for Klarna 
Checkout is “Snabbkassa”,  

Published  ‘Yes’ for payment method available, ‘No’ for disabled 

Payment description  Section for describing the  

Payment method  Selecting a specific payment integration.  Choose 
‘VMPAYMENT_KLARNA’ for Klarna Checkout. 

Shopper group  Limits the payment method to be available for specific customers. 

List order  Placement of the payment method in a list. Set ‘1’ to place Klarna 
Checkout in the top.  
 
 
 

Configuration 
1. Go to the right tab, ‘Configuration’ 
2. Enter your credentials for your Klarna Checkout configuration 
 

Country configuration 
Field  Explanation 

Purchase country  Choose the country that you want to enable Klarna Checkout for. See 
available Checkout countries here. 

E­store ID  E­store identification number, provided by Klarna upon a signed 
agreement. EIDs for testing can be requested here. 
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Shared secret  Provided by Klarna, together with an EID. 

Server  ‘Beta’ for test EIDs (test server), ‘Live’ for production. 

Purchase currency  Choose the currency that you want to enabled Klarna Checkout for. 
See available Checkout currencies here: 
http://developers.klarna.com/en/api­references­v1/klarna­checkout#sup
ported_locales 

Payment form  Combination setup to identify the customers locale. Required in the 
language  Checkout configuration. Available Checkout locales here: 
http://developers.klarna.com/en/api­references­v1/klarna­checkout#sup
ported_locales 
 
 

Order administration configuration
Field  Explanation 

Order status order  Order status set for purchases is approved by Klarna. By default set  to
confirmed  ‘Confirmed’. 

Order status order  Order status that is chosen to trigger an activation of a purchase. 
shipped   Changing to this status will send an activate to Klarna. By default set to
‘Shipped’. 

Order status is  Order status that is chosen to trigger a cancellation of a purchase. 
cancelled  Changing to this status will send a cancelReservation to Klarna. By 
default set  to ‘Cancelled’. 

Order status order  Not used at the moment. 
Change reservation 

Display Klarna logo  ‘Yes’ for showing the logo in the payment method list, ‘No’ for only 
showing text. 
 

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Settings in Virtuemart 
Round only display 
We advice you to configure Round only display. This configuration can be found in  
Joomla > Virtuemart > Configuration > Pricing > Price configuration 
 

One Page Checkout 
The Klarna Checkout will work with its potential to the fullest if you have configured “One Page 
Checkout” in Virtuemart. Go to Configuration > Configuration > Checkout > One Page Checkout 
enabled and tick the setting.  
 

Discounts 
If you offer discounts on specific products and product categories, make sure to use the same 
Type of arithmetic operation for both discounts. Separating these, using for instance Price 
modified before tax and Price modifier after tax is not working with Klarna at the moment. 

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Testing 
Purchase phase 
Once you are done with the installation and the configuration of Klarna Checkout, we advise you 
to make a test purchase to ensure that the integration is correct. 
You can use the the information of our test persons, provided here: 
http://developers.klarna.com/en/testing/invoice­and­account 
 
We only allow testing towards our test server. You can apply for a test account, to get a test EID. 
Set your configuration to server > ‘Beta’ while testing.  
 

Post purchase phase 
Order management 
Purchases done with Klarna Checkout can be managed from Virtuemart administration tool, for 
each specific order. Actions in connection to Klarna’s system is managed through changing the 
order status of an order paid with Klarna. 
 

Performing updates of the order status 
The order status management can be found in the right column in the order details.  

 
 
 
Order status  Explanation 

Confirmed  Default status upon a successful order. 

Shipped  Sends an ‘activate’ to Klarna’s system. Responding with a transaction ID
upon successfully activating the reservation. 
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Cancelled  Sends a ‘cancelReservation’ to Klarna’s system. Cancels the order in 
Klarna’s system. 
 
Note that:  
 
1. Other order statuses such as ‘Pending’, ‘Refunded’ and ‘Confirmed by shopper’ are by 
default not connected to Klarna. 
 
2. Partial activation is not possible at the moment. 
 
3. Refunds of the purchase from Virtuemart to Klarna is not possible at the moment. This is 
done in Klarna Online. 
 

 
 

Capture an order (Shipped) 
Once your order is ready to be shipped, you need to sync the action with Klarna’s system. This 
is easily done by changing the order status to ‘Shipped’. 
 
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Cancel an order (Cancelled) 
If an order would be cancelled before it is shipped, you need to sync the action with Klarna’s 
system. This is easily done by changing the order status to ‘Cancelled’.  
 

Other order management actions 
Change an order, refund an active order, etc. 
It is currently possible to change the details (address, cart) of an order that is done with Klarna. 
This is however currently not synced to Klarna’s systems, which means that all changes done to 
the orders needs to be synced within Klarna’s online­based order management tool, Klarna 
Online (for production transactions) ­ https://merchants.klarna.com. This action is valid for both 
changing orders before shipping, and making refunds to shipped orders. 

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Going live
Once you have completed your testing, it is time for you to insert your production EID and verify 
a transaction ­ before you can start taking purchases from real customers. 
 
This verification is done by Klarna’s Integration department, in direct contact with you. 
 
If you have got a production EID and are ready to launch your store with Klarna Checkout, 
contact your Klarna Integration department in order to finish your integration! 
 

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Branding 
We give several key performance indicators for you as a merchant, to be able to increase your 
sales. 

Website template 
● Klarna logotype 
Having a logotype presenting which payment methods you offer, informs the customers about 
the options they can choose from to complete their purchase. 
Contact your Integration department to get a logotype suitable for you store and locale. 
 

Checkout page 
● Klarna placed first in list of payment methods 
Klarna is the quickest way for the customer to complete a purchase in your store, as we only 
require top­of­the­head information such as social security number/date of birth, email address 
and phone number.  
 

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Troubleshooting 
Errors 
Errors that occurs in the platform and are Klarna connected, can be viewed in the Virtuemart 
error log. 
A full list of our errors can be found on our integration site: 
http://developers.klarna.com/en/api­references­v1/klarna­checkout#errors 

Orders 
Klarna’s Merchant Support department helps you with production orders and your questions 
regarding order management in Klarna Online. Remember to have you EID, and if it regards a 
specific order, relevant reservation and/or transaction ID number ready to get quick support. 
 

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

FAQ 
Q: I’m trying to configure my connection to Klarna but I receive strange errors, what went wrong 
in my integration? 
A: Ensure that the EID and shared secret provided from Klarna is pointing towards the correct 
server. 
 
 

   
 
Klarna Checkout  
Documentation & Installation guide 
Virtuemart 2.x 
 
 

Contact information
Klarna’s Integration department offers support during your integration process. 
 
If you have questions regarding the order management and features in our web interface Klarna 
Online, or questions about specific orders, our Merchant Support department is available. 
 

Integration Sales  
Sweden: 
E­mail: integration@klarna.com 

Norway 
E­mail: integration@klarna.no 

Finland 
E­mail: integration@klarna.fi 
 
 

Merchant Support
Sweden 
E­mail: merchant@klarna.se 

Norway 
E­mail: merchant@klarna.no 

Finland 
E­mail: kauppa@klarna.fi