API Guide

When the customer has chosen Klarna invoice or part payment as their way of payment, information about the purchase is sent to us through the add_transaction request. Klarna will make a credit assessment of the purchase and immediately answer back to the store. Should the purchase be declined we will return with an error message that is displayed to the customer. When the purchase is accepted, a passive invoice is created in Klarnas system. It is an invoice without a due date.

This is done when the goods are to be sent to the customer. Activation means that the store activates the purchase which gives it a due date (usually 14 days for invoice). This can be done with two simple clicks in Klarna Online or through function calls.

This is done by mail, email or printout (if you wish to place the invoice with the package) and can be done either via Klarna Online or through function calls.

When a part payment purchase is shipped, Klarna will automatically take care of the sendouts of the monthly invoices. This means that you as a merchant only has to focus on shipping the goods and let Klarna take care of the payments.

When the customer has chosen Klarna invoice or part payment as their way of payment information about the purchase is sent to us through reserve_amount. We will make a credit assessment of the purchase and answer back to the store immediately. Should the purchase be declined we will return with an error message which is displayed to the customer. The key difference here is that the reserve_amount-request creates a reservation with the amount of the order (hence the name) while add_transaction creates a passive invoice containing items that have been ordered. The benefits of this will be evident in the next step.

This is done when the goods are to be sent to the customer. When this happens the store uses the function activate_reservation which transforms the reservation to an invoice or part payment purchase with a due date (usually 14 days for invoice).

The nice part of doing it this way is when there have been changes in the order from the time of order (on the web) till it's time to ship. Examples of this is when not all goods are in stock. What happens is that the store sends the list of the shipped goods to Klarna (lets say 2 out of 3 goods) and out of this information Klarna creates the final invoice. This can also be done with the standard integration using update_goods_qty to modify the passive invoice, however it is usually simpler to use the advanced integration.

If we continue with the example we have two options: either that we are not going to ship the last item (because we will not restock it) or that we are going to ship it later. If store decides for the latter, it must add flag 16 to the activate_reservation call which holds the remaining part of the reservation that can be used later when you have received the remaining items.

This is done by mail, email or printout (if you wish to place the invoice with the package) and can be done either via Klarna Online or through function calls.

When an account purchase is activated Klarna will automatically take care of the sendouts of the monthly invoices. This means that you as a merchant does not need to add any sendouts to ours.