Klarna Invoice and Part Payment - Installation and User Guide

Product version:

EPiServer Commerce 1.0 SP1/1 R2/1 R2 SP1

Document last saved:

Table of Contents

Introduction

This document describes how to install and use the Klarna Invoice and Part Payment gateway. The module is available for EPiServer Commerce 1.0 SP1, and integrates the Klarna payment provider with EPiServer Commerce.

Installation

  1. Download the project files for Klarna payment gateway.
  2. Build the project EPiServer.Business.Commerce.Payment.Klarna in the download.
  3. Copy the EPiServer.Business.Commerce.Payment.Klarna.dll to the bin folder of both Commerce front-end and back-end sites.
  4. Copy the CookComputing.XmlRpc.dll and kreditor.dll in the Klarna /Lib folder to the bin folder of Commerce front-end site.
  5. Copy the KlarnaInvoice_EN.xml to the /lang folder of Commerce front-end site. 
  6. Copy the following folders to /Templates/Everything/BusinessControls/CheckoutControls/plugins/payment/ or /Templates/ClickTalk/Units/Placeable/plugins/payment/ if you have 1.0 R2 of the Commerce front-end site:
    - Klarna Invoice: folder KlarnaInvoice (only the files PaymentMethod.ascx, KlarnaInvoice.css and images files are required)
    - Klarna Part Payment: folder KlarnaPartPayment (only the files PaymentMethod.ascx, KlarnaPartPayment.css and all image files are required)
  7. Copy the following folders to C:\Program Files (x86)\Mediachase\eCommerceFramework\5.1\eCommerceFramework\Shared\Apps\Order\Payments\Plugins\" of the Commerce front-end site:
    - Klarna Invoice: folder KlarnaInvoice (only ConfigurePayment.ascx is required)
    - Klarna Part Payment: folder KlarnaPartPayment (only ConfigurePayment.ascx is required)

Configuration

  1. In Commerce Manager, go to Administration > Order System > Payments > Your country.
  2. Click the New button to create a new payment method. An example for Klarna Part Payment is shown below.

  3. In the Overview tab, enter the following required information for Klarna invoice/Part Payment methods respectively:

    Field nameValue Klarna InvoiceValue Klarna Part Payment
    Name Klarna Invoice Klarna Part Payment
    Description Klarna Invoice payment gateway Klarna Part Payment gateway
    System Keyword KlarnaInvoice KlarnaPartPayment
    Language The language of your choice The language of your choice
    Class Name EPiServer.Business.Commerce.Payment.
    Klarna.KlarnaInvoice.KlarnaPaymentGateway
    EPiServer.Business.Commerce.Payment.Klarna.
    KlarnaInvoice.KlarnaPaymentGateway
    IsActive Yes Yes
    IsDefault No No
    Supports Recurring No No
    Restricted Shipping Methods Add all Add all
  4. Click OK.
  5. Go to the Parameters tab to edit the Klarna Part Payment payment method.
  6. Enter the following required information, depending on the payment method to use, see explanation below.


    Parameters configuration tab for Klarna Part Payment.


    Parameters configuration tab for Klarna Invoice.

    Field nameDescriptionValue
    Test mode If you designate this flag an invoice is created in test mode, even if your store is fully operational. Recommended for testing without disrupting regular invoicing Yes or No
    Merchant ID The store ID got from Klarna Sample value: 795
    Shared secret The shared secret number got from Klarna Sample value: 52XFA9L7JtPoaCl
    Allow different address If this flag is checked, the EPiServer Commerce system will not verify the customer entered address. It will depend totally on Klarna to verity the address Yes or No
    Update pclasses button

    Only for Klarna Part Payment: will update the pclasses from Klarna. Remember to click OK in the next step as well, to save the pclasses

    Click button to update
      
  7. Click OK to save
  8. Add the following setting to the AppSettings in web.config of your Commerce front-end site:

<appSettings>
<add key="KlarnaPaymentUrl" value="http://beta-test.kreditor.se:4567" />
</appSettings>

The value to use here is the URL received when registering your store with Klarna.

Using the Klarna Part Payment Option with EPiServer Commerce

Place an order as follows:

  1. Add item to shopping cart and proceed to checkout.
  2. Select a shipping address, shipping option and change to payment options. Depending on your current country (in the shipping address), different forms for input will appear.

Sweden, Finland, Denmark and Norway

The following applies to customers from Sweden, Finland, Denmark and Norway:

  1. In the Payment Options, select the Part Payment option.
  2. In Social Security No, enter your social security number.
  3. Click Review and Place Order.

NOTE that Klarna Part Payment will not accept a company account.

Netherlands and Germany

The following applies to customers from Netherlands and Germany:

  1. For Part Payment, select the Part Payment option.
  2. Enter Gender, Birth date and House number and optional house extension.
  3. Click Review and Place Order.


     
    Finalization and order confirmation:
      
  4. If your order is successfully processed, you will see your order number. An e-mail is also sent to you to confirm your order.
  5. If you are a store owner, you can see the details of the order in the invoice of the Klarna system. You can use the TestPerson from Klarna for testing, find out more here: http://integration.klarna.com/en/api-functions/test-persons.

Using the Klarna Invoice with EPiServer Commerce

Place an order as follows:

  1. Add item to shopping cart and proceed to checkout.
  2. Select a shipping address, shipping option and change to payment options. Depending on your current country (in the shipping address), different forms for input will appear.

Sweden, Finland, Denmark and Norway

The following applies to customers from Sweden, Finland, Denmark and Norway:

  1. In the Payment Options, select the Klarna Invoice option.
  2. In Social Security No, enter the social security number for a company and select an address from the list.
  3. Click Review and Place Order.

Netherlands and Germany

The following applies to customers from Netherlands and Germany proceed as follows:

  1. In the Payment Options, select the Klarna Invoice option.
  2. Enter Gender, Birth date and House number and optional house extension.
  3. Click Review and Place Order.


        
        

      
    Finalization and order confirmation:
      
  4. If your order is successfully processed, you will see your order number. An e-mail is also sent to you to confirm your order.
  5. If you are a store owner, you can see the details of the order in the invoice of the Klarna system. You can use the TestPerson from Klarna for testing, find out more here: http://integration.klarna.com/en/api-functions/test-persons.

Related Information

EPiServer Commerce Developers Guide

EPiServer Commerce User Guide