Checkout Recurring

This feature is only available in Nordics and DACH at the present time, if you have a need for more markets contact your Klarna rep.

Recurring Orders

KCO Recurring reduces the effort for customers who want to start a subscription of any kind online. The functionality will enable you as a merchant to sell subscriptions and other recurring purchases through Klarna Checkout. It is as easy to set the subscription up as completing any purchase with Klarna Checkout. The function is based on a unique token that is created with the first purchase. This token which represents the customer and their purchase is then used to initiate an additional purchase using Klarna Payments.

Prerequisites

  • Need to be enabled in your Klarna account

1. Create a order ready for recurring

You must create a normal checkout order with the value “recurring” set to true.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
Accept: application/json
Authorization: Basic a2xhcm5hOnVuaWNvcm5z
Content-Type: application/json

{
  "purchase_country": "gb",
  "purchase_currency": "gbp",
  "locale": "en-gb",
  "order_amount": 10000,
  "order_tax_amount": 2000,
  "order_lines": [
    {
      "type": "physical",
      "reference": "123050",
      "name": "Tomatoes",
      "quantity": 10,
      "quantity_unit": "kg",
      "unit_price": 600,
      "tax_rate": 2500,
      "total_amount": 6000,
      "total_tax_amount": 1200
    }, 
    {
      "type": "physical",
      "reference": "543670",
      "name": "Bananas",
      "quantity": 1,
      "quantity_unit": "bag",
      "unit_price": 5000,
      "tax_rate": 2500,
      "total_amount": 4000,
      "total_discount_amount": 1000,
      "total_tax_amount": 800
    }
  ],
  "merchant_urls": {
    "terms": "http://toc",
    "checkout": "http://checkout?klarna_order_id={checkout.order.id}",
    "confirmation": "http://confirmation?klarna_order_id={checkout.order.id}",
    "push": "http://push?klarna_order_id={checkout.order.id}",
    "validation": "http://validation?klarna_order_id={checkout.order.id}"
  },
  "recurring": true,
  "recurring_description": "12 month subscription"     // optional field
}

2. Consumer completes the purchase

After a consumer has completed the purchase the checkout order will have a “recurring_token” property that contains the token used to create recurring orders. This token must be stored for later use. It is up to the merchant to store the token, it is not available in Order Management. The token can only be used for the same MerchantId that create the token.

3. Create the recurring order

When creating a recurring order by charging the token Klarna Payment Methods is used. More information can be found here.

Documentation about reading tokens and checking their status can be found here.