Klarna Module

Take payments through Klarna, where the client chooses to pay now, pay later or pay in instalments on Klarna's own page.

Reaching the Screen

Go to Settings → Financial → Payment Gateways, open All Modules and click the Klarna card: {admin}/modules/payment?module=Klarna

Tick Status and save to list the method on the payment step. Use Payment Gateways to order the methods clients see.

What Is on the Screen

The card holds your Klarna credentials, three behaviour settings and the shared gateway settings.

The client sees a short panel inside checkout and opens Klarna's hosted page from there, so payment details never reach your site. Which options Klarna offers depends on the client's country and the order.

Klarna can keep a payment method for later renewals and charge it without the client. Provider subscriptions, installments managed by WISECP and an on-site card form are not supported.

Before You Configure It

• A Klarna account with the Merchant portal, and an administrator user who can create API credentials.
• A separate playground account for testing. Playground and production credentials are never the same.
• The region your credentials were issued for: Europe, North America or Oceania.
• A currency and country Klarna serves. Fill in Converting Currency when your prices are in another one.

Fields

Commission, converting currency, accepted amount range and country lists behave the same on every gateway; see Payment Gateways. Callback URL, Success URL and Failed URL cannot be edited. Klarna receives these addresses with each payment, so you register nothing in your Merchant portal.

Tasks

Connect your Klarna account

1. In the Merchant portal open Payment settings → Klarna API Keys → Generate new Klarna API key. Download the credentials text file.
2. Open the Klarna card under All Modules and tick Status.
3. Enter the file's Key ID in API Username (UID) and Secret in API Password. Pick API Region and leave Playground (test) mode ticked.
4. Click Save Changes. The method now appears on the payment step.

Run a test payment

1. Place a small order as a client and choose Klarna on the payment step.
2. Click Continue to Klarna and complete the payment with Klarna's test data.
3. You return to the site. The invoice is marked as paid and the order is activated.

Switch to live

1. Create a credential in your production Merchant portal.
2. Replace API Username (UID) and API Password with the production pair and check the region.
3. Untick Playground (test) mode and click Save Changes. Repeat the test with a real low-value payment.

Capture an authorised payment

1. Leave Capture immediately off. Klarna then only blocks the money and the invoice stays open.
2. Open the invoice from Invoice Detail and click Capture payment at the top.
3. Confirm with Capture. Klarna takes the money, the payment is recorded and the invoice closes.

Offer a saved payment method

1. Tick Offer saved payment method and save.
2. The client ticks Save this payment method for future renewals on the payment panel and approves it on Klarna's page.
3. Renewal invoices are then collected from the saved method without the client.

Refund a payment

1. Open the invoice from Invoice Detail.
2. Under Summary → Change Status, select Refunded and Refund via payment gateway. Click Update Status.
3. Klarna returns the amount that was captured for this invoice.

Things to Watch

Required Privileges

Payment Module Settings (MODULES_PAYMENT_SETTINGS) is required for the settings. Capturing or refunding an invoice payment needs Billing → Edit (INVOICES_OPERATION).

Related Articles

• Payment Gateways
• Invoice Detail