Use the Order management API to check the details of an order.

When you want to check the details of an order, this API call provides you with order information like address, date, amount, purchase country, and status.

To check the order details, send a GET request to the {apiUrl}/ordermanagement/v1/orders/{order_id} endpoint. Provide the order id you want to revise as an {order_id} path parameter. The order_id is the identifier you get in a successful response when placing a new order.

You can check these details for up to three years after an order is created.

In response to your call, you receive a data object containing the order details.

{
  "order_id": "7849fd84-47dc-4919-a7ce-xxxxxxxxxx",
  "status": "CAPTURED",
  "fraud_status": "ACCEPTED",
  "order_amount": 200,
  "original_order_amount": 200,
  "captured_amount": 200,
  "refunded_amount": 0,
  "remaining_authorized_amount": 0,
  "purchase_currency": "PLN",

Sample of a successful response to check order details.

If the order id in your request is invalid, you get an error response. Ensure the order_id value you provided is correctly formatted.

You can use the correlationid and the order_id values to troubleshoot the call in the Merchant portal logs app section.

{
  "error_code": "INVALID_ORDER_ID",
  "error_messages": [
    "Order ID must be a valid UUID."
  ],
  "correlation_id": "dd482985-2e0f-415d-9f30-74ce93e7e68e"
}

Sample of an error response to check order details.

Use the Order management API to update the total amount of an order before it is captured, canceled, or expired.

When your customer contacts you to change, add, or remove a product from the order and you need to update the total order amount, this API call enables you to make the required changes.

The updated amount replaces the original order amount, including the order lines if you sent them when creating an order.

The following diagram depicts how this API call works:

You can only update the amount if the order meets the following conditions:

• The order isn’t fully captured, canceled, or expired.
• For increasing an authorized amount, we run a second risk assessment or credit lookup on the customer. If the update is rejected following the assessment, your customer has to place a new order in your online store for the new items.
• Only certain payment methods support increasing the authorized amount, as shown in the table below:

To update the order amount, send the updated order details in a PATCH request to the {apiUrl}/ordermanagement/v1/orders/{order_id}/authorization endpoint. The order_id is the identifier you get in a successful response when placing a new order.

Include the following in your request:

• order_amount (required): the new amount for the order. If you’re decreasing the order amount, this has to be less than the current authorized amount. If you’re increasing the order amount, this has to be more than the current authorized amount
• description (optional): text to add details
• order_lines (optional): the new order lines that will replace the existing ones

{
  "order_amount": 6000,
  "description": "",
  "order_lines": [
    {
      "type": "physical",
      "reference": "123050",
      "name": "Tomatoes",
      "quantity": 10,
      "quantity_unit": "kg",

Sample request to update the order amount.

We recommend you always send updated order lines to improve the customer experience. The order lines can later help your customer visualize their purchase in the Klarna app and in the invoice.

If the request is successful, the order amount is updated, and you'll receive a 204 No content response.

If your request contains errors, you'll receive an error response. Make sure your request meets the conditions for updating the order and the parameters are correct. You can use the correlation_id and the order_id values to troubleshoot the call in the Merchant portal Logs section.

{
  "error_code": "NOT_ALLOWED",
  "error_messages": [
    "Update not allowed."
  ],
  "correlation_id": "a3183112-74bc-44ac-9453-51af2577d717"
}

Sample of an error response to update order amount.

Use the Order management API to update the order ID (merchant references).

When you want to use your own order ID or make any change to the order ID we provide, you have to send an API call to update the merchant references.

A merchant reference is the order number you assign to the order in your system, different from the default one we provide when creating the order. Your customers can use the merchant reference identifier to inquire about the purchase they made in your store.

To update the merchant references, send the updated references in a PATCH request to the apiUrl}/ordermanagement/v1/orders/{order_id}/merchant-references.

The order_id is the identifier you get in a successful response when placing a new order.

{
    "merchant_reference1": "15632423",
    "merchant_reference2": "special order"
}

Sample request to update merchant references.

You can update one or both references (merchant_reference1 and merchant_reference2). You can also clear a reference by setting its value to "" (empty string). You can use either one or both merchant references. The parameter merchant_reference1 is the order id from your system.

If the request is successful, the merchant reference is updated, and you'll receive a 204 No content response.

If your request contains errors, you'll receive an error response. Make sure the order_id is correct. You can use the correlation_id and the order_id values to troubleshoot the call in the Merchant portal Logs section.

{
  "error_code": "NO_SUCH_ORDER",
  "error_messages": [
    "Order cannot be found. Merchant references cannot be updated."
  ],
  "correlation_id": "17c50e6c-c79d-4174-9369-4b58bca2d2ab"
}

Sample of an error response to update merchant references.

Use the Klarna order management API to update your customer's shipping address.

When your customer wants to change their shipping address, you have to send an API request to change the address associated with that order.

After you update this information, the customer undergoes another credit check.

To update the customer's shipping address, send the updated addresses in a PATCH request to the {apiUrl}/ordermanagement/v1/orders/{order_id}/customer-details. The order_id is the identifier you get in a successful response when placing a new order.

To clear a field, set its value to “” (empty string). However, you can't clear mandatory fields.  Refer to the Order management API reference to learn which fields are mandatory.

{
  "shipping_address": {
    "street_address": "123 Fake St",
    "postal_code": "12345",
    "city": "New York",
    "region": "NY",
    "country": "US"
  }
}

Sample request to update the customer's shipping address.

If the request is successful, the order is updated, and you'll receive a 204 No content response.

If your request contains errors, you'll receive an error response. It can be due to our risk assessment.

Also, make sure the order_id is correct. You can use the correlation_id and the order_id values to troubleshoot the call in the Merchant portal Logs section.

{
  "error_code": "NOT_ALLOWED",
  "error_messages": [
    "Billing address cannot be updated for user account order. Customer details cannot be updated."
  ],
  "correlation_id": "b1fbf280-ea6e-4aee-a6ea-58b4b458ef47"
}

Sample of an error response to update customer address.

Use the Order management API to add shipping information to an order and enable delivery tracking.

When you want to add shipping details to an order, you can send the shipping details after creating the order, as explained in this API call. This call can be used for a better customer experience when shipping information is available before capturing the order.

By adding the shipping details on order level, you make this information available to your customers so that they can keep track of the delivery.

To add the shipping information to an order, send a POST request to the {apiUrl}/ordermanagement/v1/orders/{order_id}/shipping-info endpoint.

Provide order_id as path parameter. The order_id is the identifier you get in a successful response when placing a new order.

Include the following required body parameters in your request:

• return_shipping_company: name of the shipping company for the return shipment
• return_tracking_number: tracking number that identifies the return shipment
• return_tracking_uri: URL where the customer can track the return shipment
• shipping_company: logistics company (carrier) managing the delivery. For more information, see the carrier list.
• shipping_method: method for delivering the goods
• tracking_number: tracking number that identifies the shipment
• tracking_uri: URI where the customer can track their shipment

{
  "shipping_info": [
    {
      "return_shipping_company": "DHL US",
      "return_tracking_number": "93456415674545679888",
      "return_tracking_uri": "http://shipping.example/findmypackage?93456415674545679888",
      "shipping_company": "DHL US",
      "shipping_method": "Home",
      "tracking_number": "63456415674545679874",
      "tracking_uri": "http://shipping.example/findmypackage?63456415674545679874"

Sample request to add shipping information.

You can add different shipping information for different items in the same call. For example, suppose a single order includes two packages associated with two different shipments and tracking numbers; in that case, you have to send the shipping_info details for each item.

If your request is successful, you'll receive a 204 No content response.

If your request contains errors, you'll receive an error response. Ensure the order_id value you provided is valid and correctly formatted.

You can use the correlation_id and the order_id values to troubleshoot the call in the Merchant Portal logs section.

{
  "error_code": "NO_SUCH_ORDER",
  "error_messages": [
    "Order 7849fd84-47dc-4919-a7ce-47b9f46156f cannot be found. Shipping info cannot be added to order 7849fd84-47dc-4919-a7ce-47b9f46156f."
  ],
  "correlation_id": "f072554f-ef99-4b21-85da-633355aab998"
}

Sample of an error response to add shipping information.

Use the Order management API to cancel uncaptured orders.

When your customers don't want to proceed with the purchase and need to cancel their order before you capture it, send an API call to cancel the authorization.

When you cancel the order, we release the authorized amount and you can't make further updates to the order.

To successfully cancel the order, don’t capture any items listed in it.

The following diagram depicts how this API call works:

To cancel an authorized order, send a POST request to the {apiUrl}/ordermanagement/v1/orders/{order_id}/cancel.

The order_id is the identifier you get in a successful response when placing a new order. You don't need a request body for this POST method.

If the request is successful, the order is canceled, and you'll receive a 204 No content response.

If your request contains errors, you'll receive an error response. It can be because the order has captures or is closed.

{
  "error_code": "CANCEL_NOT_ALLOWED",
  "error_messages": [
    "Order has previous captures. Cancel not possible."
  ],
  "correlation_id": "95ccbcb1-8963-4569-b721-1a354"
}

Sample of an error response to cancel an order.

Make sure the order_id is correct. You can use the correlation_id and the order_id values to troubleshoot the call in the Merchant portal Logs section.

Use the Order management API to acknowledge your Klarna checkout orders.

When you integrate our [ Klarna checkout solution], you’ll receive a push notification anytime your customers use Klarna in your store. Upon receiving this notification, you let us know that you're aware of the order by calling our order acknowledgment endpoint. This step is required if you're integrating Klarna checkout into your online business.

To acknowledge an order, send a POST request to the {apiUrl}/ordermanagement/v1/orders/{order_id}/acknowledge endpoint.

The order_id is the identifier you get in a successful response when placing a new order. You don't need a request body for this POST method.

If the request is successful, you'll receive a 204 No content response.

If your request contains errors, you'll receive an error response. Make sure the order_id is correct.

You can use the correlation_id and the order_id values to troubleshoot the call in the Merchant portal logs section.

{
  "error_code": "NO_SUCH_ORDER",
  "error_messages": [
    "Order 7849fd85-47dc-4919-a7ce-47b9f461562f cannot be found. Acknowledgement not possible."
  ],
  "correlation_id": "c56002ca-81ee-436a-b213-093e5afe75d3"
}

Sample of an error response to acknowledge your Klarna checkout orders.