API and SDKsSupport
How to install Klarna on WooCommerce

This article provides guidelines on installing Klarna in your WooCommerce store.

Before you begin, please ensure the following:

  • Your store is accessible via HTTPS (SSL certificate is required).
  • You have an active agreement with Klarna.
  • To check Klarna’s country availability, visit: Klarna for WooCommerce

Begin by downloading the Klarna for WooCommerce extension from the official source

Ensure your environment meets the following version requirements:

  • PHP: Check your PHP version here.
  • WordPress: Confirm your WordPress version is compatible here.
  • Klarna Plugin: Verify the extension version here.
  • WooCommerce: Check your WooCommerce version here.

After downloading, install the plugin in your WordPress admin panel. Navigate to Plugins > Installed Plugins > Klarna for WooCommerce > Activate to enable the extension.

Log in to the Klarna Merchant Portal and navigate to the Settings section to generate your Klarna API credentials (API username and password).

Enter the generated API credentials in the appropriate section for the region(s) where you intend to offer Klarna.

Klarna API credentials are specific to either Production or Test environments—they cannot be used in both. In the picture for step 4, you can find an option to enable or disable Test Mode as needed.

Before accepting live payments, we recommend that you use Test Mode to ensure your integration works as expected. Please follow these steps to set up the test mode for your WooCommerce store:

  1. Enter this page to sign up for an European test account. If you're merchant is on another market, please enter the page and select the accurate market for your store.
  2. Type your email address and click SIGN-UP. You'll get a confirmation email to this address.
  3. Open the confirmation email and click Activate account.
  4. Finish setting up your account by
    1. Accepting the Terms & Conditions
    2. Choose a new password
    3. Enter your name
    4. Log in to the Merchant Portal
  5. Once you have accessed the Merchant Portal, go to Setting > Klarna API Keys and click the Generate Klarna API key button.
  6. Download the .txt file and close the dialog box.
  7. Back in your store admin panel for Woo, mark the box "Enable Klarna in Klarnas's test environment". Enter your new Klarna API credentials that you received for the playground environment and click "Save Changes".<br />

For detailed documentation on Klarna for WooCommerce, see here. If you experience any issues first check this Troubleshooting Guide step by step. If still not resolved, contact merchant@klarna.com for support.