Files
medusa-store/docs/content/add-plugins/klarna.md
Shahed Nasser d1b4b11ff6 chore(docs): added eslint to lint documentation code blocks (#2920)
* docs: added rule for code length

* chore: fixes based on vale errors

* changed to use eslint

* fixes using eslint

* added github action for documentation eslint

* changed allowed max-length

* fixed incorrect heading level

* removed comment
2022-12-30 18:44:46 +02:00

3.0 KiB
Raw Blame History

Klarna

In this document, youll learn how to integrate Klarna as a payment provider in Medusa.

Introduction

Klarna is a payment provider that allows customers to pay in different ways including direct payment, installment payments, payment after delivery, and more.

You can integrate Klarna into Medusa using the official plugin.


Prerequisites

Medusa Components

It is assumed that you already have a Medusa server installed and set up. If not, you can follow the quickstart guide.

In addition, youll need to use the Medusa Admin to enable the payment provider in later steps. You can alternatively use the REST APIs.

Needed Accounts


Install Plugin

On your Medusa server, run the following command to install the plugin:

npm install medusa-payment-klarna

Then, add the following environment variables:

KLARNA_BACKEND_URL=<YOUR_KLARNA_BACKEND_URL>
KLARNA_URL=<YOUR_KLARNA_URL>
KLARNA_USER=<YOUR_KLARNA_USER>
KLARNA_PASSWORD=<YOUR_KLARNA_PASSWORD>
KLARNA_TERMS_URL=<YOUR_KLARNA_TERMS_URL>
KLARNA_CHECKOUT_URL=<YOUR_KLARNA_CHECKOUT_URL>
KLARNA_CONFIRMATION_URL=<YOUR_KLARNA_CONFIRMATION_URL>

Where:

  • <YOUR_KLARNA_BACKEND_URL> is your Klarna URL.
  • <YOUR_KLARNA_URL> is the base Klarna URL based on your environment.
  • <YOUR_KLARNA_USER> and <YOUR_KLARNA_PASSWORD> are your API credentials.
  • <YOUR_KLARNA_TERMS_URL>, <YOUR_KLARNA_CHECKOUT_URL>, and <YOUR_KLARNA_CONFIRMATION_URL> are the terms, checkout, and confirmation URL of your Klarna account.

Finally, in medusa-config.js, add the Klarna plugin to the plugins array with the necessary configurations:

const plugins = [
  // other plugins...
  {
    resolve: `medusa-payment-klarnal`,
    options: {
      backend_url: process.env.KLARNA_BACKEND_URL,
      url: process.env.KLARNA_URL,
      user: process.env.KLARNA_USER,
      password: process.env.KLARNA_PASSWORD,
      merchant_urls: {
        terms: process.env.KLARNA_TERMS_URL,
        checkout: process.env.KLARNA_CHECKOUT_URL,
        confirmation: process.env.KLARNA_CONFIRMATION_URL,
      },
    },
  },
]

Enable Klarna in Regions

To use Klarna in your store, you must enable it in at least one region.

You can follow this user guide to learn how to enable a payment provider in a region. You can alternatively use the REST APIs.


See Also