Key | Format | CND | Description | Beschreibung |
|---|
TaxAmount | n..10 | M | Gross amount of value added tax in the smallest currency unit (e.g. EUR Cent). The amount may not be negative. Notice: The VAT included is calculated for 19% with the formula =gross prices / 1.19 * 0.19. Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit). | Gesamtbetrag der MwSt. in der kleinsten Währungseinheit (z.B. EUR Cent). Der Betrag darf nicht negativ sein. Hinweis: Die enthaltene MwSt. berechnet sich bei 19% mit der Formel =Bruttopreis / 1,19 * 0,19. Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. |
Key | Format | CND | Description | Beschreibung |
|---|
| RTF | a1 | O | For repeat payments (subscriptions): I = Initial payment of a new subscription, R = Routine payment (Recurring). Due to the call of the HPP is always 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). Da es sich beim Aufruf der HPP immer um die Initialzahlung eines Abos handelt, muss der Wert I übergeben werden. | bdCountryCode | a2 | M | Country 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> and Poland <PL> | 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> und Polen <PL> | | bdFirstName | ans..30 | M | First name. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted. | Vorname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden. | | bdLastName | ans..30 | M | Last name. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted. | Nachname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden. | | bdEmail | ans..80 | M | Email address. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted. | E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden. | | bdCompany | ans..200 | O | Company name | Firmenname | | bdRegion | ans..40 | O | Region | Region | | bdTitle | ans..20 | O | Title of customer or contact person, e.g. Dr. or Prof. | Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof. | | bdStreet | a..32 | M | Street and street number. Optional – if submitted, all parameters bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity must be submitted. | Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden. | | bdZip | n..5 | M | Postal code. 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. | | bdCity | a..32 | M | Town/city. 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. | | bdAddressAddition | ans..60 | O | Additional/supplementary address line | Zusätzliche/ergänzende Adresszeile | | sdCountryCode | a2 | O | Country 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> and Poland <PL> | 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> und Polen <PL> | | sdFirstName | ans..30 | C | First name. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted. | Vorname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden. | | sdLastName | ans..30 | C | Last name. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted. | Nachname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden. | | sdEmail | ans..80 | C | E-mail address. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted. | E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden. | | sdCompany | ans..200 | O | Company name | Firmenname | | sdRegion | ans..40 | O | Region | Gebiet | | sdTitle | ans..20 | O | Title of customer or contact person, e.g. Dr. or Prof. | Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof. | | sdStreet | a..32 | C | Street name and street number. Optional – if submitted, all parameters sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity must be submitted. | Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden. | | sdZip | n..5 | C | Postcode. 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. | | sdCity | a..32 | C | City. 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. | | sdAddressAddition | ans..60 | O | Additional/supplementary address line | Zusätzliche/ergänzende Adresszeile | | Language | a2 | M | Language for displaying the widgets: DE - German, DK - Danish, FI - Finnish, SE - Swedish, NO - Norwegian, NL - Dutsch, FR - French, IT - Italian, EN - English, ES - Spanish, CA - Catalan, PL - Polish | Sprache, in der die Widgets angezeigt werden sollen: DE - deutsch, DK - dänisch, FI - finnisch, SE - schwedisch, NO - norwegisch, NL - niederländisch, FR - französisch, IT - italienisch, EN - englisch, ES - Spanisch, CA - katalanisch, PL - polnisch |
Key | Format | CND | Description | Beschreibung |
|---|
| IPAddr | ans..15 | O | IP address of the client in the format IPv4 or IPv6 | IP-Adresse des Clients im Format IPv4 oder IPv6 | | Account | ans..12 | M | With  it is possible to store details for several Klarna merchant accounts (username and password). Account allows you to control which account data to use. The value of this parameter must be agreed with  . | Bei  können mehrere Klarna Händler-Account-Daten (Benutzername und Kennwort) hinterlegt werden. Über Account kann gesteuert werden, welche Account-Daten man verwendet. Der Wert für diesen Parameter muss mit dem  abgestimmt werden. | | ArticleList | ans..2048 | M | 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 must be replaced with two zeros, thus for example 2500. The value may not be negative. 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'. type = type of item position. Possible entries are <physical>, <discount>, <shipping_fee>, <sales_tax>, <digital>, <gift_card>, <store_credit>, <surcharge> {
"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. 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. type = Typ der Artikelposition. Mögliche Werte sind <physical>, <discount>, <shipping_fee>, <sales_tax>, <digital>, <gift_card>, <store_credit>, <surcharge> {
"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. | | EnhancedData | ans..2048 | O | Additional customer and order information for Klarna risk management. Merchant must agree with Klarna which data will be transmitted here. This parameter must be created in JSON format. {
"marketplace_seller_info": [
{
"product_category": "Women's Fashion",
"product_name": "Women Sweatshirt"
}
]
} |
Afterwards the additional information created in JSON format must be Base64 encoded. | Zusätzliche Kunden- und Bestellinformationen für das Klarna Risikomanagement. Welche Daten hier übermittelt werden, muss mit Klarna vereinbart werden. Dieser Parameter muss im JSON-Format erstellt werden. {
"marketplace_seller_info": [
{
"product_category": "Women's Fashion",
"product_name": "Women Sweatshirt"
}
]
} |
Anschließend müssen die im JSON-Format erstellten Zusatzinformationen Base64 encodiert werden. | | Layout | ans..2048 | O | Layout parameters for Klarna widgets. This parameter must be created in JSON format. {
"options": {
"color_border": "#FF9900",
"color_border_selected": "#FF9900",
"color_button": "#FF9900",
"color_button_text": "#FF9900",
"color_checkbox": "#FF9900",
"color_checkbox_checkmark": "#FF9900",
"color_details": "#FF9900",
"color_header": "#FF9900",
"color_link": "#FF9900",
"color_text": "#FF9900",
"color_text_secondary": "#FF9900",
"radius_border": "5px"
}
} |
Afterwards the layout parameters created in JSON format must be Base64 encoded. | Layout-Parameter für die Klarna-Widgets. Dieser Parameter muss im JSON-Format erstellt werden. {
"options": {
"color_border": "#FF9900",
"color_border_selected": "#FF9900",
"color_button": "#FF9900",
"color_button_text": "#FF9900",
"color_checkbox": "#FF9900",
"color_checkbox_checkmark": "#FF9900",
"color_details": "#FF9900",
"color_header": "#FF9900",
"color_link": "#FF9900",
"color_text": "#FF9900",
"color_text_secondary": "#FF9900",
"radius_border": "5px"
}
} |
Anschließend müssen die im JSON-Format erstellten Layout-Parameter Base64 encodiert werden. | Order | ans..6 | O | Activates the automatic order creation. If this parameter is used an explicit order creation is not necessary. If a BillingAgreementID for recurring payments should be created, also the parameter RTF=I must be submitted. Only possible value: AUTO If you would like to use the automatic order processing direct through  (request parameter does not have to be sent), please contact the Merchant Service directly ( ) and our team will store the required setting directly at your account.| | Aktiviert die automatische Auftragsanlage. Wird dieser Parameter benutzt, muß keine explizite Auftragsanlage mehr erfolgen. Wenn auch eine BillingAgreementID für wiederkehrende Zahlungen erzeugt werden soll, muß auch der Parameter RTF=I mitgesendet werden. Einziger möglicher Wert: AUTO. Möchten Sie das automatische Order processing direkt durch das  nutzen (Request-Parameter muss nicht gesendet werden), wenden Sie sich bitte direkt an den Merchant Service ( ) und unser Team wird für Sie die benötigte Einstellung direkt am Account hinterlegen. |
Key | Format | CND | Description | Beschreibung |
|---|
| URLNotify | ans..256 | O | Complete URL which calls up in order to notify the shop about the payment result, if a PENDING transaction was finalized. The URL may be called up only via port 443 It may not contain parameters: Use the UserData parameter instead. Processing of PENDING transactions must be activated at as well as Klarna. URLNotify can also be stored with . | Vollständige URL, die das aufruft, um den Shop zu benachrichtigen, wenn eine PENDING-Transaktion finalisiert wurde. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData. Die Verarbeitung von PENDING-Transaktionen muss sowohl bei also auch bei Klarna freigeschaltet sein. Die URLNotify kann auch bei hinterlegt werden. | | Key | Format | CND | Personal details of customer | Personendaten des Kunden |
|---|
| DateOfBirth | dttm | O | Date of birth in the format YYYY-MM-DD | Geburtsdatum im Format JJJJ-MM-TT | | Gender | a..15 | O | Gender <female> for female, <male> for male | Geschlecht <female> für weiblich, <male> für männlich | | Title | a..12 | O | Salutation | Anrede | | SocialSecurityNumber | a..5 | O | Private individuals: The last four or five digits of the social security number. Not in DE, AT and NL. Obligatory field in SE, FI, DK with 4-digit value (NNNN). Obligatory field in NO with 5-digit value (NNNNN). | Bei Privatpersonen: Die letzten vier bis fünf Stellen der Sozialversicherungsnummer. Nicht in DE, AT und NL. Pflichtfeld in SE, FI, DK mit 4-stelligem Wert (NNNN). Pflichtfeld in NO mit 5-stelligem Wert (NNNNN). | | PersonID | ans..15 | O | National identity number. Is necessary for example for a visa to entry the USA. For that purpose the serial number on the upper right side of the iodentity card may be used. | Nationale Identitätsnummer. Wird zum Beispiel für das Visum für die Einreise in die USA benötigt. Hierfür kann die Seriennummer rechts oben auf dem Personalausweis verwendet werden. | | LegalForm | ans..50 | O | Type of company. Following values are possible: - LIMITED_COMPANY
- PUBLIC_LIMITED_COMPANY
- ENTREPRENEURIAL_COMPANY
- LIMITED_PARTNERSHIP_LIMITED_COMPANY
- LIMITED_PARTNERSHIP
- GENERAL_PARTNERSHIP
- REGISTERED_SOLE_TRADER
- SOLE_TRADER
- CIVIL_LAW_PARTNERSHIP
- PUBLIC_INSTITUTION
- OTHER
| Firmentyp. Folgende Werte sind möglich: - LIMITED_COMPANY
- PUBLIC_LIMITED_COMPANY
- ENTREPRENEURIAL_COMPANY
- LIMITED_PARTNERSHIP_LIMITED_COMPANY
- LIMITED_PARTNERSHIP
- GENERAL_PARTNERSHIP
- REGISTERED_SOLE_TRADER
- SOLE_TRADER
- CIVIL_LAW_PARTNERSHIP
- PUBLIC_INSTITUTION
- OTHER
| | CompanyID | ans..15 | O | For companies: Register of Companies number | Bei Unternehmen: Handelsregisternummer | | CompanyOrPerson | a2 | O | Indication whether it is e company or a person. <C> for companies, <P> for persons Please note that Klarna does not allow B2B transactions by default. Please contact Klarna if you also want to use the payment method for B2B transactions. | Angabe, ob es sich um eine Firma oder eine Person handelt. <C> für Firmen, <P> für Personen Bitte beachten Sie, dass seitens Klarna standardmäßig keine B2B-Transaktionen möglich sind. Bitte wenden Sie sich an Klarna, falls Sie die Zahlart auch für B2B-Transaktionen verwenden möchten. | | VatID | ans..15 | O | VAT identification number | Umsatzsteuer-Identifikationsnummer |
|
|
|
