Klarna Module

6 views Markdown

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

StatusTurns the module on. While it is off the other fields stay locked and clients are never offered the method.
API Username (UID)Required. The username half of a Klarna API credential pair.
API PasswordRequired. The password half of the same pair. Klarna shows it once.
API RegionThe Klarna region the credentials belong to: Europe, North America or Oceania. Credentials work in one region only.
Playground (test) modeSends every request to Klarna's test environment, where no money moves. On by default, so turn it off before you open the method to clients.
Capture immediatelyTakes the money as soon as the order is placed. On by default. Turn it off only when your Klarna contract asks you to capture at shipment; the invoice then waits for you.
Offer saved payment methodShows the client a save option on the payment panel and keeps the method for renewals. On by default.

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

An authorised payment is not your money yet

With Capture immediately off, the client's funds are only blocked and the invoice waits. Nothing captures it for you. A Klarna authorisation also expires, and after that there is nothing left to capture.

Playground collects nothing

Test payments mark invoices as paid and activate orders, but no money moves. Swap in the production credential and untick Playground (test) mode together: a playground pair is refused in production, and so is the wrong region.

Saving requires client consent

Turning off Offer saved payment method hides the saving option for new payments. Previously saved methods remain. A new method is saved only when the client selects the option and approves it at Klarna.

Required Privileges

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

Was this helpful?

Thanks for your feedback!

Still Need Help?

Our support team is here around the clock for anything you can't find above.

Contact Us Open a Ticket

We use cookies to keep you signed in, remember your language and currency, and improve the site. Cookie Policy