018307: New PSP integration with Klarna

Overview

Khaos Control have implemented an integration with the Klarna Payment Platform.
Note: Also see 018728: Bank Reconciliation Process for Klarna.

Specification

The integration is not capable of taking Klarna payments in the back-office software. The payments are to be taken from the web portal and tokenised information is passed to Khaos Control for use in back-office processes.

The tokens arrive in a pre-authorised state and Khaos Control will process final authorisation of these tokens via the authorise payments stage of [ Sales Invoice Manager ].

Tokens are also used to provide refunds through to the customer from the normal places in Khaos Control, i.e. Refund Notes, Credit Notes and the [ Customer | Detail | Statement ] tab.  

Configuration

A Change log and an update will be applied as a part of this development, other steps for configuration are as follows:

DLL Deployment

DLL’s for this integration must be placed in a subfolder titled PSP in the applications directory, i.e. if your KhaosControl.exe is in c:\bin\khaoscontrol\ then the DLL folder will be c:\bin\khaoscontrol\PSP\. KCSL will set up the DLL files and folders.

System Data Configuration

The settings for this card integration can be found in the [ System Data | Card Integration Accounts ] screen. The recommended System Data Configuration for this integration are as follows:

• Integration Type: Klarna.
• Token Swap: Unticked.
• Copy PreAuth to following payments: Unticked.
• PreAuth full order value: Unticked.

Right click on the card integration and select Configure to open the Integration Options Dialog and set the following configuration options:

• Testing: this denotes whether to connect to the testing endpoint when ticked, this can be used for training purposes, and will connect to the production / live endpoint when unticked.
• Username & Password: will be supplied by Klarna.

Usage

Steps for usage are as follows:

For Normal orders

Klarna Payments can be authorised as normal in the following areas:

• [ Sales Invoice Manager ]
  
• [ Sales Order | Detail | Payment ]
  

For Order Imports

The following tags must be present within the <PAYMENTS_DETAILS> tags of the XML import file:

• PAYMENT_TYPE: 2, card payments.
• PREAUTH: -1, must be pre-Authed.
• PAYMENT_AMOUNT: the amount from the Klarna order.
• CARD_NAME: the buyer from the Klarna order.
• AUTH_CODE: the Klarna reference from the order
• TRANSACTION_ID: the Klarna Order ID which is used for PostAuth (Capture/Refund)

See Also

Visit KhaosWikiX at https://support.khaoscontrol.com/wiki_kcx/ to see the following:

• System Data overview
• System Data "How Tos"