Klarna - Integration - Documentation Axepta BNP Paribas (2024)

Key

Format

CND

Description

BeschreibungTokenExtans..36MAuthorisation token which is returned from Klarna within JavaScript Authorize-Call. Please note, the authorization token from the previous step is valid for 60 minutes. If you attempt to place an order with this after that time has passed, it will be rejected by Klarna.Autorisierungs-Token, welchen Klarna im JavaScript Authorize-Call zurückgibt. Bitte beachten Sie, der erhaltene Authorization-Token eine Gültigkeit von 60 Minuten hat. Wird dieser > 60min. gesendet, wird die Anfrage seitens Klarna abgelehnt.EventTokenenumM

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.

RTFa1O

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.

RequestReasona..20O

Intended usage of „Consumer Token“.

Possible value is SUBSCRIPTION.

Beabsichtigte Nutzung des „Consumer Tokens“.

Möglicher Wert ist SUBSCRIPTION.

Noteans..50ODescription for the purpose of token (e.g. Abo)Beschreibung für den Zweck des Tokens (z.B. Abo)ArticleListans..2048M

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 = "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.

bdCountryCodea2MCountry code for the invoicing address, 2 characters according to ISO 3166-1. Allowed are Germany <DE>, Austria <AT>, Netherlands <NL>, Denmark <DK>, Sweden <SE>, Norway <NO>, Finland <FI>, Great Britain <GB>, USA <US>, Switzerland (CH), Australia (AU), Belgium <BE>, Spain (ES), Italy <IT>, Ireland <IE>, Poland <PL>, <PT> Portugal, <FR> France and <CA> Canada.Ländercode der Rechnungsadresse zweistellig gemäß ISO-3166-1. Erlaubt sind Deutschland <DE>, Österreich <AT>, Niederlande <NL>, Dänemark <DK>, Schweden <SE>, Norwegen <NO>, Finnland <FI>, Großbritannien <GB>, USA <US>, Schweiz <CH>, Australien <AU>, Belgien <BE>, Spanien (ES), Italien <IT>, Irland <IE>, Polen <PL>, <PT> Portugal, <FR> Frankreich und <CA> Kanada.bdFirstNameans..30C

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: -''.

bdLastNameans..30C

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: -''.

bdEmailans..80C

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.

bdCompanyans..200CCompany name, mandatory for B2B, must be the same as sdCompany.Firmenname, Pflichtparameter für B2B, muss identisch sein mit sdCompany.bdRegionans..40ORegionGebietbdTitleans..20OTitle of customer or contact person, e.g. Dr. or Prof.Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.bdStreeta..32C

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: -'´`",.:;#&/()+@ °ºᵃª_ \

bdZipn..5CPostcode. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted.Postleitzahl. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.bdCitya..32CCity. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted.Ort. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.bdAddressAdditionans..60OAdditional/supplementary address lineOrt. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.sdCountryCodea2OCountry code for the delivery address, 2 characters according to ISO 3166-1. Allowed are Germany <DE>, Austria <AT>, Netherlands <NL>, Denmark <DK>, Sweden <SE>, Norway <NO>, Finland <FI>, Great Britain <GB>, USA <US>, Switzerland (CH), Australia (AU), Belgium <BE>, Spain (ES), Italy <IT>, Ireland <IE>, Poland <PL>, <PT> Portugal, <FR> France and <CA> Canada.Ländercode der Lieferadresse zweistellig gemäß ISO-3166-1. Erlaubt sind Deutschland <DE>, Österreich <AT>, Niederlande <NL>, Dänemark <DK>, Schweden <SE>, Norwegen <NO>, Finnland <FI>, Großbritannien <GB>, USA <US>, Schweiz <CH>, Australien <AU>, Belgien <BE>, Spanien <ES>, Italien <IT>, Irland <IE>, Polen <PL>, <PT> Portugal, <FR> Frankreich und <CA> Kanada.sdFirstNameans..30C

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: -''.

sdLastNameans..30C

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: -''.

sdEmailans..80C

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.

sdCompanyans..200CConpany name, mandatory for B2B, must be the same as bdCompany.Firmenname, Pflichtparameter für B2B, muss identisch sein mit bdCompany.sdRegionans..40ORegionGebietsdTitleans..20OTitle of customer or contact person, e.g. Dr. or Prof.Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.sdStreeta..32C

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: -'´`",.:;#&/()+@ °ºᵃª_ \

sdZipn..5CPostcode. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted.Postleitzahl. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.sdCitya..32CCity. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted.Ort. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.sdAddressAdditionans..60OAdditional/supplementary address lineZusätzliche/ergänzende Adresszeile