@agoransson/klarna-payments NPM

Typescript wrapper for Klarna Payments API

This is not an official Klarna product, they take no responsibility for this product. And I have no affiliation with Klarna.

This library is meant for the back-end server, it's not to be confused with the official Javascript SDK released by Klarna which is used in the front-end.

The example application included in this repository uses both

Installation

How to use this library

Initialize the library

const config = {
    isLive: true/false;
    region: REGION.EU / REGION.US / REGION.OCEANIA;
    username: <klarna merchant username>;
    password: <klarna merchant password>;
};

const payments = new Payments({
    config
});

Create new credit session

This is a minimal example on how to create a new Credit Session, for a complete set of attributes read the official Klarna API documentation.

const session = {
    locale: Locale.sv_SV;
    order_amount: 1;
    order_lines: [
        {name: "The product", quantity: 1, total_amount: 1000, unit_price: 1000}
    ];
    purchase_country: "SE";
    purchase_currency: "SEK";
};

const result = await payments.v100.sessions.createCreditSession(session);

const { client_token, payment_method_categories, session_id } = result;

Create a new order

This is a minimal example on how to create a new Order, for a complete set of attributes read the official Klarna API documentation.

// Authorization token is created from the front-end script, when the user authorizes the purchase.

const authorizationToken = "<string from front-end authorization process>";

const order = {
    locale: Locale.sv_SV;
    order_amount: 1;
    order_lines: [
        {name: "The product", quantity: 1, total_amount: 1000, unit_price: 1000}
    ];
    purchase_country: "SE";
    purchase_currency: "SEK";
};

const result = await payments.v100.orders.createOrder(authorizationToken, order);

Cancel authorization

TODO: Write example

Generate consumer token

TODO: Write example

Read credit session

TODO: Write example

Update credit session

TODO: Write example

Running the example locally

Note that this example requires you to have access to a merchan-portal. By default, it is set to use the playground endpoints, you can change this in the Express server (index.js), the front-end is a simple HTML with JQuery, found in a single file (index.html) served through express.

This is a minimal example showing how to interact with Klarna, your production implementation will of course look different!