Key
Format
CND
Description
Defines which Klarna API-Call request will be initiated.
For creating a Klarna order the value CNO must be transferred.
Definiert welcher Klarna API-Call Request angestoßen wird.
Beim Anlegen der Klarna Bestellung muss der Wert CNO übergeben werden.
For repeat payments (subscriptions): I = Initial payment of a new subscription, R = Routine payment (Recurring).
If this is an initial payment of a subscription the value I must be transferred.
Bei wiederkehrenden Zahlungen (Abos): I = Initialzahlung eines neuen Abos, R = Wiederkehrende Zahlung (Recurring).
Wenn es sich um die Initialzahlung eines Abos handelt, muss der Wert I übergeben werden.
Intended usage of „Consumer Token“.
Possible value is SUBSCRIPTION.
Beabsichtigte Nutzung des „Consumer Tokens“.
Möglicher Wert ist SUBSCRIPTION.
Complete article list of the order. This parameter must be created in JSON format.
The individual parameters in JSON format are following:
name = Product name (mandatory)
quantity = item quantity. The value may not be negative. (mandatory)
unit_price = unit price inclusive taxes but without rebates. (mandatory)
total_amount = total amount of iarticles inclusive taxes and rebates. (mandatory)
image_url = URL for an image that can be embedded later in agreement with Klarna. (max. 1024 characters)
merchant_data = "pass-through parameter" (max. 255 characters). Merchant must agree with Klarna what will be transmitted here.
product_identifiers.brand = product brand
product_identifiers.category_path = path of product category. As separator '>' has to be used.
product_identifiers.global_trade_item_number = article number (e.g. EAN, ISBN or UPC).
product_identifiers.manufacturer_part_number = manufacturer’s number
product_url = URL to product image
quantity_unit = unit of quantity (e.g. kg)
reference = article number (e.g. SKU)
tax_rate = tax rate as percentage (e.g. 25%). The percent sign muss be replaced with two zeros, thus for example 2500. The value may not be negative. (mandatory)
total_discount_amount = total amount of rebate. The value may not be negative.
total_tax_amount = total amount of taxes. The value may be negative, if type is 'discount'. (mandatory)
type = type of item position. Possible entries are <physical>, <discount>, <shipping_fee>, <sales_tax>, <digital>, <gift_card>, <store_credit>, <surcharge>
Example:
{"order_lines": [{"image_url": "https://www.exampleobjects.com/logo.png","merchant_data": "","name": "Battery Power Pack","product_identifiers": {"brand": "Intel","category_path": "Electronics Store > Computers & Tablets > Desktops","global_trade_item-number": "735858293167","manufacturer_part_number": "BOXNUC5CPYH"},"product_url": "https://www.estore.com/products/f2a8d7e34","quantity": 1,"quantity_unit": "kg","reference": "19-402-USA","tax_rate": 0,"total_amount": 1000,"total_discount_amount": 0,"total_tax_amount": 0,"type": "physical","unit_price": 1000}]}
Afterwards the article list created in JSON format must be Base64 encoded.
Komplette Artikelliste der Bestellung. Dieser Parameter muss im JSON-Format erstellt werden.
Die einzelnen Parameter im JSON-Format sind folgende:
name = Produktname (Pflicht)
quantity = Artikelmenge. Der Wert darf nicht negativ sein. (Pflicht)
unit_price = Einzelpreis inkl. Steuern aber exkl. Rabatte. (Pflicht)
total_amount = Gesamtbetrag der Artikel inkl. Steuern und Rabatte. (Pflicht)
image_url = URL zu einem Bild, welches später in Absprache mit Klarna eingebettet werden kann. (max. 1024 Zeichen)
merchant_data = "Durchreich-Parameter" (max. 255 Zeichen). Was hier übermittelt wird, muss mit Klarna abgestimmt werden.
product_identifiers.brand = Produktmarke
product_identifiers.category_path = Pfad der Produktkategorie. Als Trennzeichen muss '>' verwendet werden.
product_identifiers.global_trade_item_number = Artikelnummer (z.B. EAN, ISBN oder UPC).
product_identifiers.manufacturer_part_number = Herstellernummer
product_url = URL zum Produktbild
quantity_unit = Mengeneinheit (z.B. kg)
reference = Artikelnummer (z.B. SKU)
tax_rate = Steuersatz in Prozent (z.B. 25%). Das Prozentzeichen muss durch zwei Nullen ersetzt werden, also zum Beispiel 2500. Der Wert darf nicht negativ sein. (Pflicht)
total_discount_amount = Gesamtbetrag des Rabattes. Der Wert darf nicht negativ sein.
total_tax_amount = Gesamtbetrag der Steuern. Der Wert darf negativ sein, wenn der type 'discount' ist. (Pflicht)
type = Typ der Artikelposition. Mögliche Werte sind <physical>, <discount>, <shipping_fee>, <sales_tax>, <digital>, <gift_card>, <store_credit>, <surcharge>
Beispiel:
{"order_lines": [{"image_url": "https://www.exampleobjects.com/logo.png","merchant_data": "","name": "Battery Power Pack","product_identifiers": {"brand": "Intel","category_path": "Electronics Store > Computers & Tablets > Desktops","global_trade_item-number": "735858293167","manufacturer_part_number": "BOXNUC5CPYH"},"product_url": "https://www.estore.com/products/f2a8d7e34","quantity": 1,"quantity_unit": "kg","reference": "19-402-USA","tax_rate": 0,"total_amount": 1000,"total_discount_amount": 0,"total_tax_amount": 0,"type": "physical","unit_price": 1000}]}
Anschließend muss die im JSON-Format erstellte Artikelliste Base64 encodiert werden.
First name. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted.
Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.
Vorname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''.
Last name. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted.
Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.
Nachname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''.
Email address. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted.
Must include @ and domain.
E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
Muss @ und Domain enthalten.
Street name and street number. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted.
Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \
Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
Erlaubte Sonderzeichen: -'´`",.:;#&/()+@ °ºᵃª_ \
First name. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted.
Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.
Vorname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''.
Last name. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted.
Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.
Nachname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''.
Email address. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted.
Must include @ and domain.
E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
Muss @ und Domain enthalten.
Street name and street number. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted.
Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \
Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
Erlaubte Sonderzeichen: -'´`",.:;#&/()+@ °ºᵃª_ \