For a number of different reasons there could be a need to validate the order before it is completed. You can register a callback (where you can do the final merchant validation) on the order create that Klarna will call when the consumer clicks the buy button.
Read more in theĀ API documentation
*SeeĀ Cards and 3D Secure
Make sure to include the optional propertyĀ merchant_urls.validation.Ā when you configure the checkout order.
Note:Ā All communication with the validation URI will be encrypted. For that reason you must use the HTTPS protocol for this URI.
"merchant_urls": {
"terms": "https://toc",
"checkout": "https://checkout?klarna_order_id={checkout.order.id}",
"confirmation": "https://confirmation?klarna_order_id={checkout.order.id}",
"push": "https://push?klarna_order_id={checkout.order.id}",
"validation": "https://validation?klarna_order_id={checkout.order.id}"
}
When the consumer clicks ābuy nowā a POST request will be sent to theĀ merchant_urls.validation. The body of the request will contain the current order information. The structure of the order information is identical to the result of fetching the order, as you saw in render the checkout.
Note:Ā There is no need to fetch the order from Klarna since all the order information is included in the POST request body.
Once you receive the POST request, our system will expect a response within 3 seconds. If Klarna does not receive a response, we will approve the purchase. The response you provide Klarna will determine whether or not the purchase will be completed:
Note:Ā The rejection page needs to be hosted by you, and we highly recommend that you give the consumer detailed information as to why you rejected the order.
Responding to the validation callback withĀ HTTP
Ā statusĀ 200 OK
Ā will not always guarantee that the order is completed, for example if the consumer is paying using card and triggeringĀ 3D SecureĀ authentication. When authentication is completed then a reservation is made on the customerās card, in case a validation callback is fired after the authentication event and is responded to with anĀ HTTP 303
Ā (in this context: deny purchase) response status, Klarna will still retain the reservation on the customerās card.
Hence, whenever Klarna reserves money this happens as the last part of the purchase flow. Therefore anĀ HTTP 200 OK
Ā response status followed by failedĀ 3D Secure
Ā authentication does not allow for completing the order and does not redirect the customer to the confirmation page.