Skip to main content

Klarna Checkout V3 Adapter Developer Guide (Legacy Shopping)

Legacy Path

This page describes the legacy payment flow via the Shopping Service. If you are implementing Norce Checkout (NCO), these instructions do not apply. Please refer to the Norce Checkout Documentation instead.

Configurations​

TODO

Payment interactions​

The interaction with the adapter is done with GetPaymentForm, Validate and Callback by Norce Commerce Services and CreateInvoice, CreditPayment by Norce Commerce Connect.

GetPaymentForm​

Norce will call Klarna and create a Klarna order with an order id (checkout id in Norce). The payment response object has a snippet that you render on your page.

Important payment parameters​

NameConfiguration (link)Is RequiredNote
confirmationurlShopCallbackUrlyesNorce appends basketId={BasketId}&klarna_order_id={checkout_id} to the url before passing it to klarna (if addparameter is set)
addparametersnoIndicates if the confirmationurl should have checkout_id and basketId as query parameters.
termsurlHttpReportUrlyesURL to merchant terms and conditions.
paymenttermorgurlnoURL to merchant terms and conditions for b2b.
checkouturlShopCheckoutUrlyesUrl to the merchant checkout page (the page that will render the snippet)
validationurlShopValidationUrlOptional url to validation, before payment is done by Klarna.
validationcontenttypecontent type for the validation callback. application/json, text/xml
CountryCode (or country)Primary Country (on application)no
localeCultureCodeno
b2bnoonly, yes, yesorganizationasdefault, yescompanyasdefault
If the session should allow b2b purchases.
ShippingCountries (*)nocomma-separated list of countries, allowed to ship to. (Country above is always included by klarna)
tagsComma separated custom strings that should be passed to Klarna.
cancelurlThe url where users get redirected when something goes wrong.
allowseparateshippingaddressIndicates of the psp should allow separate addresses for shipping and billing
ShowSubtotalDetailIndicated if subtotal should be expanded
RequiredPhoneNumberIndicated if phone number is mandatory
additional_merchant_termsThis is an optional additional text about terms and conditions.
ipaddress
accountinfo

Payment Validation​

TODO

Payment Callback​

TODO

Create Invoice (capture the payment)​

TODO

Credit Payment​

TODO

Other functionality​

TODO

Recurring orders​

TODO

Suggested further reading​