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
| Name | Configuration (link) | Is Required | Note |
|---|---|---|---|
| confirmationurl | ShopCallbackUrl | yes | Norce appends basketId={BasketId}&klarna_order_id={checkout_id} to the url before passing it to klarna (if addparameter is set) |
| addparameters | no | Indicates if the confirmationurl should have checkout_id and basketId as query parameters. | |
| termsurl | HttpReportUrl | yes | URL to merchant terms and conditions. |
| paymenttermorgurl | no | URL to merchant terms and conditions for b2b. | |
| checkouturl | ShopCheckoutUrl | yes | Url to the merchant checkout page (the page that will render the snippet) |
| validationurl | ShopValidationUrl | Optional url to validation, before payment is done by Klarna. | |
| validationcontenttype | content type for the validation callback. application/json, text/xml | ||
| CountryCode (or country) | Primary Country (on application) | no | |
| locale | CultureCode | no | |
| b2b | no | only, yes, yesorganizationasdefault, yescompanyasdefault If the session should allow b2b purchases. | |
| ShippingCountries (*) | no | comma-separated list of countries, allowed to ship to. (Country above is always included by klarna) | |
| tags | Comma separated custom strings that should be passed to Klarna. | ||
| cancelurl | The url where users get redirected when something goes wrong. | ||
| allowseparateshippingaddress | Indicates of the psp should allow separate addresses for shipping and billing | ||
| ShowSubtotalDetail | Indicated if subtotal should be expanded | ||
| RequiredPhoneNumber | Indicated if phone number is mandatory | ||
| additional_merchant_terms | This 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