In this section, you will learn more about how to manage your orders after they have been shipped using Klarna’s order management API.

Retrieve a capture.
Add new shipping information to a capture.
Trigger a new send out of customer communication.
Refund an amount of a captured order.
Release the remaining authorization for an order.

• You have already obtained your API credentials
• You have captured the amount stated in the delivery page

Tip: You can read more in-depth technical content on the API / SDK reference page.

Retrieving all information related to a capture, e.g. shipping/billing information or order lines that were captured.

You need to view what information is related to a shipped item.

Send in the order id and the specific capture id you want to know more about.

1
2
3
GET /ordermanagement/v1/orders/{order_id}/captures/{capture_id}
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Content-Type: application/json

Klarna will respond with one of the following:

Error message - something went wrong

200 - OK - The server has fulfilled the request and the capture information is returned

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
46
47
48
49
50
51
52
53
54
55
56
57
HTTP/1.1 200 OK
Content-Type: application/json

{
  "capture_id": "5b33ed47-79d0-4d76-99ea-4afaa7c8e552",
  "klarna_reference": "4K7Q6QF6-1",
  "captured_amount": 6000,
  "captured_at": "2017-01-10T10:31:17.973Z",
  "description": "Shipped the full order",
  "order_lines": [
    {
      "reference": "123050",
      "type": "physical",
      "quantity": 10,
      "quantity_unit": "kg",
      "name": "Tomatoes",
      "total_amount": 6000,
      "unit_price": 600,
      "total_discount_amount": 0,
      "tax_rate": 2500,
      "total_tax_amount": 1200
    }
  ],
  "refunded_amount": 0,
  "billing_address": {
    "given_name": "John",
    "family_name": "Doe",
    "title": "Mr",
    "street_address": "123 Fake St",
    "postal_code": "12345",
    "city": "New York",
    "region": "NY",
    "country": "US",
    "email": "john@doe.com",
    "phone": "123456"
  },
  "shipping_address": {
    "given_name": "John",
    "family_name": "Doe",
    "title": "Mr",
    "street_address": "123 Fake St",
    "postal_code": "12345",
    "city": "New York",
    "region": "NY",
    "country": "US",
    "email": "john@doe.com",
    "phone": "123456"
  },
  "shipping_info": [
    {
      "shipping_company": "DHL US",
      "tracking_number": "1234567890",
      "return_shipping_company": "UPS",
      "return_tracking_number": "112233445566778899"
    }
  ]
}

Shipping information can be attached to a capture, this will help you and us to keep track of orders sent to the customer. Read more about delivery tracking .

You have made a capture of your order, now after sending the order you want to add the shipping details.

Send in the shipping details and add them to a specific capture.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
POST /ordermanagement/v1/orders/{order_id}/captures/{capture_id}/shipping-info
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Content-Type: application/json

{
  "shipping_info": [
    {
      "shipping_company": "DHL US",
      "tracking_number": "1234567890",
      "return_shipping_company": "UPS",
      "return_tracking_number": "112233445566778899"
    }
  ]
}

Klarna will respond with one of the following:

Error message - something went wrong

201 - Created - The server has fulfilled the request

Trigger a new send out of customer communication and settlement details. Typically used to inform customers about changes to their order. This triggers an email to the customer with the latest details.

The customer did not receive the invoice as expected and you want to send a new invoice.

1
2
3
POST /ordermanagement/v1/orders/{order_id}/captures/{capture_id}/trigger-send-out
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Content-Type: application/json

Klarna will respond with one of the following:

Error message - something went wrong

204 - No Content - The server has fulfilled the request

In case of a 404 response, the response body will indicate whether the order or capture was not found

Refund an amount of a captured order. The refunded amount will be credited back to the customer. The refunded amount must not be higher than captured_amount. The refunded amount can optionally be accompanied by a descriptive text and order lines. Sending updated order lines allows Klarna to visualize what was refunded to the custumer.

The customer sends item(s) back and you need to refund the customer with the specific amount.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
POST /ordermanagement/v1/orders/{order_id}/refunds
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Content-Type: application/json

{
  "refunded_amount": 3000,
  "description": "Refunding half the tomatoes",
  "order_lines": [
    {
      "type": "physical",
      "reference": "123050",
      "name": "Tomatoes",
      "quantity": 5,
      "quantity_unit": "kg",
      "unit_price": 600,
      "tax_rate": 2500,
      "total_amount": 3000,
      "total_tax_amount": 600
    }
  ]
}

Klarna will respond with one of the following:

Error message - something went wrong

201 - Created - The server has fulfilled the request

Signal that there is no intention to perform further captures and remaining amount should be released. If the purchase was made by card then Klarna will refund the remaining authorization to the customer.

You and the customer are happy with the delivery and you have no need to change or update the order. The custumer should thus not be debited for the remaining order amount, if the custumer has paid by card the remaining amount should be refunded to the customer.

You need the specific order id to release the remaining authorization.

1
2
3
POST /ordermanagement/v1/orders/{order_id}/release-remaining-authorization
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Content-Type: application/json

Klarna will respond with one of the following:

Error message - something went wrong

204 - No Content - The server has fulfilled the request