Use the Order management API to make a refund with fees when your customers want to return items.
When your customers ask for a refund and want to return the items they bought, you can charge a return fee using this API call.
Your customers are charged with this return fee at the moment of refund, meaning that we take the return fee from the refunded amount they receive.
Charging the return fee is only possible if the orders meet the required conditions:
To charge return fees, you have to call the same endpoint you use for refunding an order, but with
type: return_fee as an additional parameter in
POST request to the
Include the following in your request:
Klarna-Idempotency-Key : This header will guarantee the idempotency of the operation. The key should be unique and is recommended to be a UUID version 4. Retries of requests are safe to be applied in case of errors such as network errors, socket errors and timeouts.
refunded_amount (required): the total order amount to be refunded. It must be less or equal to the captured_amount from the order capture
reference (optional): Internal reference to the refund. This will be included in the settlement files.
description (optional): text to add details of the refunds. Your customers can see this description
order_lines (required): list of details associated with this capture. You have to add an extra order line representing the return fee and set its
You must add the parameter
type: return_fee in the order lines to charge the return fee successfully. Adding this parameter lets your customer visualize the fee in the Klarna app.
If the request is successful, you'll receive a
201 Created response, including
location as HTTP response headers.
If your request contains errors, you'll receive an error response. Make sure the order is already captured and the
order_id in the request is correct.
You can use the
correlation_id, and the
order_id values to troubleshoot the call in the Merchant portal logs section.
You can also remove the charged fees added in the request explained above. For this action, you have to send a new request to refund an order, including the amount previously charged as a return fee.
Ready to send this request? See the API reference of this call.