Klarna Accounts

To add or edit a Klarna account, proceed as follows:

1. Have your Klarna credentials to hand. You can generate them from your Klarna portal under: Menu > Settings > Credentials >API-Credentials > Generate new API credentials.
2. Ensure that the main Application Setting 'Enable Payment By Klarna' (in the 'Payment' grouping) is enabled. Alternatively, you can check the Enable Klarna Payment button at the top of the KlarnaAccounts.aspx page.
3. Go to Payment Processing > Klarna Accounts in the IRP left navigation menu.
4. To add a new account, click the Add New Klarna Account button at the top of the page.
5. To edit an existing account, click the Edit button beside the account that you want to edit.
6. Complete the details on each of the tabs on the KlarnaAccountEdit.aspx page, as described in the sections that follow.

1. Enter or edit the following details:

   Setting	Description
   Account Details
   Account ID	This is the unique ID of the account, added automatically by the IRP.
   Active	Check this box if you are ready to make this Klarna account active. Only active accounts will be available to customers on the payment details stage of checkout.
   Admin Name	Enter a name to easily identify this Klarna account in IRP Admin.
   Currency	Select the currency of the Klarna account, for example GBP or EUR.
   Environment	Select the environment (Europe or North America) of this Klarna account.
   Use Playground	Check this box if you want this Klarna account to use the Playground (sandbox) instead of full Production mode. Payments are not taken for Playground orders.
   Allowed IP Addresses	When testing, you may wish to enable this Klarna Account for a set of IP Addresses. If so, add a comma-separated list of IP Addresses you wish the account to be visible for. If you want this Klarna Account to be available to anyone, leave this text box empty.
   Payment Categories
   Pay Now Enabled	Check this box only if Pay Now has been enabled on this Klarna Account - Payment Categories enabled on your Klarna Accounts can be established by contacting your Klarna Account manager. Enabling this will ensure that a placeholder is displayed on the Payment Details page within checkout. If Klarna deems Pay Now is not available for a customer's session, a label will appear that informs the customer about this. If you enable this option then you should also provide the following details: Min Price: This will be displayed in the 'Not Available' label on the Payment Details page of checkout if there is a lower limit for Klarna Pay Now and Klarna has deemed that Pay Now is not available for the customer's session. Max Price: This will be displayed in the 'Not Available' label on the Payment Details page of checkout if there is an upper limit for Klarna Pay Now and Klarna has deemed that Pay Now is not available for the customer's session.
   Pay Later Enabled	Check this box only if Pay Later has been enabled on this Klarna Account - Payment Categories enabled on your Klarna Accounts can be established by contacting your Klarna Account manager. Enabling this will ensure a placeholder is displayed on the Payment Details page within checkout. If Klarna deems Pay Later is not available for a customer's session, a label will appear that informs the customer about this. If you enable this option then you should also provide the following details: Min Price: This will be displayed in the 'Not Available' label on the Payment Details page of checkout if there is a lower limit for Klarna Pay Later and Klarna has deemed that Pay Later is not available for the customer's session. Max Price: This will be displayed in the 'Not Available' label on the Payment Details page of checkout if there is an upper limit for Klarna Pay Later and Klarna has deemed that Pay Later is not available for the customer's session.
   Pay Over Time Enabled	Check this box only if Pay Over Time Enabled has been enabled on this Klarna Account - Payment Categories enabled on your Klarna Accounts can be established by contacting your Klarna Account manager. Enabling this will ensure a placeholder is displayed on the Payment Details page within checkout. If Klarna deems Pay Over Time is not available for a customer's session, a label will appear that informs the customer about this. If you enable this option then you should also provide the following details: Min Price: This will be displayed in the 'Not Available' label on the Payment Details page of checkout if there is a lower limit for Klarna Pay Over Time and Klarna has deemed that Pay Over Time is not available for the customer's session. Max Price: This will be displayed in the 'Not Available' label on the Payment Details page of checkout if there is an upper limit for Klarna Pay Over Time and Klarna has deemed that Pay Over Time is not available for the customer's session.
   Credentials
   Username	Enter the username component of the API credentials for this Klarna Account. You can find this (or generate it) from within the Klarna portal.
   Password	Enter the password component of the API credentials for this Klarna Account. You can find this (or generate it) from within the Klarna portal.

2. Click the Insert Klarna Account button or the Update Klarna Account button to save the details. If this is the first time you are saving account details, you should see a confirmation message at the top of the page: 'Klarna Account Successfully Added'.

This tab is where you define the countries in which the Klarna account will be available.

1. Select countries in the 'Add Available Countries' box (Hold Ctrl or Shift to select multiple countries).
2. Click the Add button to move the countries to the 'Countries Account Available In' box.
3. Click the Update Klarna Account button.
4. If you want to remove countries, select them in the 'Countries Account Available In' box and click the Remove button.

To view Klarna transactions, proceed as follows:

1. Go to Payment Processing > Klarna Accounts in the IRP left navigation menu.
2. Click the Klarna Transactions button at the top of the page. This takes you to the KlarnaTransactions.aspx page:

3. To find specific transactions, enter a search term in the search bar at the top of the page. If you expand 'Other Options' under the search bar you can refine your results using the following filters:
   • Show: Choose to show only successful transactions, failed transactions or all transactions.
   • Transaction Type: Select a specific type of transaction from the drop-down list:
     • Any Transaction Type
     • Create Credit Session
     • Authorize Payment
     • Reauthorize Payment
     • Place Order
     • Capture Order
     • Cancel Order
     • Order Notification
     • Order Status Check
     • Refund Order
     • Global Variables Fetch
   • Account: Select a specific Klarna account from the drop-down list.
   • Date Range: Enter an appropriate date range in the boxes provided.
4. When you click the Search button you can see your search results in the main grid on the page. This shows the following information for each transaction returned:
   • ID: This is the unique IRP identifier of the Klarna transaction.
   • Transaction Type: This is the type of the transaction (e.g. Authorize Payment, Create Credit Session, Order Notification, etc.).
   • Account: This is the IRP Admin name of the account.
   • Amount: This is the total amount that was transacted.
   • Customer ID: This is the ID of the customer involved in the transaction.
   • Order ID: This is the ID of the order involved in the transaction.
   • Successful: This indicates whether or not the transaction was deemed successful.
   • TimeStamp: This is the day, date and time when the transaction occurred.
   • Details: Click this button to drill down into the details of any transaction. This takes you to the KlarnaTransactionDetails.aspx page. For more details, see Transaction Details below.

When you click the Details button against any transaction on the KlarnaTransactions.aspx page you go to the KlarnaTransactionDetails.aspx page:

Here you can see the following information (not all shown in the screen capture above):

Transaction Details:

• ID: This is the unique IRP identifier for the Klarna transaction.
• Transaction Type: This is the type of the Klarna transaction (e.g. Authorize Payment, Create Credit Session, Order Notification, etc.).
• Merchant Reference: This is a reference for the Klarna transaction that you can use to refer to transactions within the Klarna Merchant portal.
• Successful: This indicates whether or not the Klarna transaction was deemed successful. Any error messages relating to this transaction will be displayed within the 'Errors Details' section on this page.
• Generated: This is the date and time when the Klarna transaction occurred.
• Order ID: This is the Order ID associated with the Klarna transaction. Click the View button to open the Order Manage page for this order.
• Account: This is the Klarna Account used to generated the transaction. Click the Edit button to open the Klarna Account Edit page for the Account associated with this transaction.
• Session ID: This is the Session ID associated with the Klarna transaction. Session IDs are created when Klarna initially starts a payment session for a customer. This Session ID is carried through the customer's journey on the site and stored against all transactions leading up to and including 'Place Order'.
• Use Playground: This indicates whether or not the Klarna transaction used the Playground (sandbox) instead of full Production mode. Payments are not taken for Playground orders.

Error Details:

Here you can see details of any errors generated as part of the Klarna transaction (e.g. 'Failed Klarna Authorization).

Request:

Here you can see the Request content of the Klarna transaction. This may include details such as the purchase country, purchase currency, customer name, billing address, delivery address, order amount, stock item name and so forth.

Response:

Here you can see the Response content of the Klarna transaction (e.g. error: invalid fields).