Klarna Payments

Logo

Info

Das Paygate beherrscht Rechnungs- und Ratenkauf von Klarna. Sie profitieren dabei von einer Zahlungsgarantie und kurzen Auszahlungszyklen.

Als dritte Variante integriert Klarna die Bezahlung per Sofort-Überweisung und abgesicherte Lastschrift.

Type

Gemischte Zahlarten

Format

Beschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)

Abkürzung

Beschreibung

Kommentar

CND

Bedingung (condition)

M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

TaxAmount

"amount": { "taxTotal": ...}

n..10

OC

Gesamtbetrag der MwSt. in der kleinsten Währungseinheit (z.B. EUR Cent). Der Betrag darf nicht negativ sein.

Pflicht, wenn tax_rate und total_tax_amount im Parameter ArticleList angegeben sind.

Hinweis: Die enthaltene MwSt. berechnet sich bei 19% mit der Formel =Bruttopreis / 1,19 * 0,19.

Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

bdCountryCode

"billing": {"addressInfo": { "country": { "A2": "..." }}}

a2

M

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.

bdFirstName

"billing": {"consumer": { "firstName": "..." }}

ans..30

C

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

bdLastName

"billing": {"consumer": { "lastName": "..." }}

ans..30

C

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

bdEmail

"billing": {"contactInfo": { "email": "..." }}

ans..80

C

E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

Muss @ und Domain enthalten.

bdCompany

"billing": {"business": { "companyLegalName": "..." }}

ans..200

C

Firmenname, Pflichtparameter für B2B, muss identisch sein mit sdCompany.

bdRegion

"billing": {"addressInfo": { "region": "..." }}

ans..40

O

Gebiet

bdTitle

"billing": {"consumer": { "salutation": "..." }}

ans..20

O

Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.

bdStreet

"billing": {"addressInfo": { "addressLine1": {"street+streetNumber": "..." }}}

a..32

C

Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

Erlaubte Sonderzeichen: -'´‘",.:;#&/()+@ °ºᵃª_ \

bdZip

"billing": {"addressInfo": { "postalCode": "..." }}

n..5

C

Postleitzahl. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

bdCity

"billing": {"addressInfo": { "city": "..." }}

a..32

C

Ort. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

bdAddressAddition

"billing": {"addressInfo": { "addressLine2": "..." }}

ans..60

O

Zusätzliche/ergänzende Adresszeile

sdCountryCode

"shipping": {"addressInfo": { "country": { "A2": "..." }}}

a2

O

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.

sdFirstName

"shipping": {"consumer": { "firstName": "..." }}

ans..30

C

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

sdLastName

"shipping": {"consumer": { "lastName": "..." }}

ans..30

C

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

sdEmail

"shipping": {"contactInfo": { "email": "..." }}

ans..80

C

E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

Muss @ und Domain enthalten.

sdCompany

"shipping": {"business": { "companyLegalName": "..." }}

ans..200

C

Firmenname, Pflichtparameter für B2B, muss identisch sein mit bdCompany.

sdRegion

"shipping": {"addressInfo": { "region": "..." }}

ans..40

O

Gebiet

sdTitle

"shipping": {"consumer": { "salutation": "..." }}

ans..20

O

Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.

sdStreet

"shipping": {"addressInfo": { "addressLine1": {"street+streetNumber": "..." }}}

a..32

C

Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

Erlaubte Sonderzeichen: -'´‘",.:;#&/()+@ °ºᵃª_ \

sdZip

"shipping": {"addressInfo": { "postalCode": "..." }}

n..5

C

Postleitzahl. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

sdCity

"shipping": {"addressInfo": { "city": "..." }}

a..32

C

Ort. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

sdAddressAddition

"shipping": {"addressInfo": { "addressLine2": "..." }}

ans..60

O

Zusätzliche/ergänzende Adresszeile

Language

"language": "..."

a2

M

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

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

IPAddr

"browserInfo": {"ipAddress": "..."}

ans..15

O

IP-Adresse des Clients im Format IPv4 oder IPv6

Account

"payment": {"klarna": { "accountName": "..." }}

ans..12

M

Im Paygate können mehrere Klarna-Benutzernamen auf einer MerchantID hinterlegt und durch den Parameter Account angesteuert werden. Standardmäßig verwenden Sie bitte den Wert "0", bei mehreren Klarna-Accounts stimmen Sie die Werte bitte mit Computop Helpdesk ab.

ArticleList

"order": {"items": "..."}

ans..2048

M

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, wenn total_tax_amount oder Parameter TaxAmount angegeben ist.)

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, wenn tax_rate oder Parameter TaxAmount angegeben ist.)

type= Typ der Artikelposition. Mögliche Werte sind <physical>, <discount>, <shipping_fee>, <sales_tax>, <digital>, <gift_card>, <store_credit>, <surcharge>

1
{
2
	"order_lines": [
3
		{
4
			"image_url": "https://www.exampleobjects.com/logo.png",
5
			"merchant_data": "",
6
			"name": "Battery Power Pack",
7
			"product_identifiers": {
8
				"brand": "Intel",
9
				"category_path": "Electronics Store > Computers & Tablets > Desktops",
10
				"global_trade_item-number": "735858293167",
11
				"manufacturer_part_number": "BOXNUC5CPYH"
12
			},
13
			"product_url": "https://www.estore.com/products/f2a8d7e34",
14
			"quantity": 1,
15
			"quantity_unit": "kg",
16
			"reference": "19-402-USA",
17
			"tax_rate": 0,
18
			"total_amount": 1000,
19
			"total_discount_amount": 0,
20
			"total_tax_amount": 0,
21
			"type": "physical",
22
			"unit_price": 1000
23
		}
24
	]
25
}

Anschließend muss die im JSON-Format erstellte Artikelliste Base64 encodiert werden.

EnhancedData

"payment": {"klarna": { "enhancedData": "..." }}

ans..2048

O

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.

1
{
2
	"marketplace_seller_info": [
3
		{
4
			"product_category": "Women's Fashion",
5
			"product_name": "Women Sweatshirt"
6
		}
7
	]
8
}

Anschließend müssen die im JSON-Format erstellten Zusatzinformationen Base64 encodiert werden.

Layout

"payment": {"klarna": { "layout": "..." }}

ans..2048

O

Layout-Parameter für die Klarna-Widgets. Dieser Parameter muss im JSON-Format erstellt werden.

1
{
2
	"options": {
3
		"color_border": "#FF9900",
4
		"color_border_selected": "#FF9900",
5
		"color_button": "#FF9900",
6
		"color_button_text": "#FF9900",
7
		"color_checkbox": "#FF9900",
8
		"color_checkbox_checkmark": "#FF9900",
9
		"color_details": "#FF9900",
10
		"color_header": "#FF9900",
11
		"color_link": "#FF9900",
12
		"color_text": "#FF9900",
13
		"color_text_secondary": "#FF9900",
14
		"radius_border": "5px"
15
	}
16
}

Anschließend müssen die im JSON-Format erstellten Layout-Parameter Base64 encodiert werden.

URLConfirm

"urls": {"confirm": "..."}

ans..256

M

Finale Bestellbestätigungs-URL, auf die Klarna den Kunden leitet, nachdem die Bestellung im Klarna-System erfolgreich angelegt wurde.

URLNotify

"urls": {"notify": "..."}

ans..256

O

Vollständige URL, die das Paygate 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 Computop also auch bei Klarna freigeschaltet sein. Die URLNotify kann auch bei Computop hinterlegt werden.

PayType

"payment": {"klarna": { "paymentType": "..." }}

enum

M

Vom Kunden ausgewählte Klarna-Zahlungsart. Mögliche Werte sind Sofort bezahlen (pay_now, direct_debit oder direct_bank_transfer), Später bezahlen (pay_later), In Raten bezahlen (pay_over_time) oder One Klarna (klarna).

Personendaten des Kunden

DateOfBirth

"billing": {"consumer": { "birthdate": "..." }}

dttm

O

Geburtsdatum im Format JJJJ-MM-TT

Gender

"billing": {"consumer": { "gender": "..." }}

a..15

O

Geschlecht <female> für weiblich, <male> für männlich

Title

"billing": {"consumer": { "salutation": "..." }}

a..12

O

Anrede

SocialSecurityNumber

"billing": {"consumer": { "socialSecurityNumber": "..." }}

a..5

O

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

"billing": {"consumer": { "consumerId": "..." }}

ans..15

O

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

"payment": {"klarna": { "legalForm": "..." }}

ans..50

C

Firmentyp. Pflichtparameter für B2B. 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

"billing": {"business": { "companyRegistrationNumber": "..." }}

ans..15

O

Bei Unternehmen: Handelsregisternummer, nur für B2B von Bedeutung, aber kein Pflichtparameter.

CompanyOrPerson

a2

O

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

"payment": {"klarna": { "vatId": "..." }}

ans..15

O

Umsatzsteuer-Identifikationsnummer, nur für B2B von Bedeutung, aber kein Pflichtparameter.

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Status

"status": "AUTHORIZE_REQUEST"

"status": "FAILED"

a..50

M

AUTHORIZE_REQUEST (URLSuccess) und FAILED (URLFailure)

Description

"description": "..."

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Code

"code": ...

n1..8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes). Code "0": Führen Sie nun die Autorisierung über das Klarna Widget im Frontend durch.

CodeExt

"externalErrorCode": ...

ans..50

O

Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen

ErrorText

"errorText": "..."

ans..1024

O

Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen

AccessToken

"payment": { "accessToken": "..." }

ans..2048

O

Client-Token von Klarna. Um anschließend die entsprechenden Klarna-Widgets anzeigen zu können, muss die Klarna JavaScript-API mit diesem Token initialisiert werden.

PayType

"payment": {"klarna": { "paymentType": "..." }}

enum

M

Vom Kunden ausgewählte Klarna-Zahlungsart. Mögliche Werte sind Sofort bezahlen (pay_now, direct_debit oder direct_bank_transfer), Später bezahlen (pay_later), In Raten bezahlen (pay_over_time) oder One Klarna (klarna). Der zurückgegebene Wert entscheidet darüber, welche Widgets geladen werden dürfen.

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

TaxAmount

"amount": { "taxTotal": ...}

n..10

OC

Gesamtbetrag der MwSt. in der kleinsten Währungseinheit (z.B. EUR Cent). Der Betrag darf nicht negativ sein.

Pflicht, wenn tax_rate und total_tax_amount im Parameter ArticleList angegeben sind.

Hinweis: Die enthaltene MwSt. berechnet sich bei 19% mit der Formel =Bruttopreis / 1,19 * 0,19.

Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

RTF

–––

a1

O

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

"billing": {"addressInfo": { "country": { "A2": "..." }}}

a2

M

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.

bdFirstName

"billing": {"consumer": { "firstName": "..." }}

ans..30

C

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

bdLastName

"billing": {"consumer": { "lastName": "..." }}

ans..30

C

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

bdEmail

"billing": {"contactInfo": { "email": "..." }}

ans..80

C

E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

Muss @ und Domain enthalten.

bdCompany

"billing": {"business": { "companyLegalName": "..." }}

ans..200

C

Firmenname, Pflichtparameter für B2B, muss identisch sein mit sdCompany.

bdRegion

"billing": {"addressInfo": { "region": "..." }}

ans..40

O

Gebiet

bdTitle

"billing": {"consumer": { "salutation": "..." }}

ans..20

O

Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.

bdStreet

"billing": {"addressInfo": { "addressLine1": {"street+streetNumber": "..." }}}

a..32

C

Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

Erlaubte Sonderzeichen: -'´‘",.:;#&/()+@ °ºᵃª_ \

bdZip

"billing": {"addressInfo": { "postalCode": "..." }}

n..5

C

Postleitzahl. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

bdCity

"billing": {"addressInfo": { "city": "..." }}

a..32

C

Ort. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

bdAddressAddition

"billing": {"addressInfo": { "addressLine2": "..." }}

ans..60

O

Zusätzliche/ergänzende Adresszeile

sdCountryCode

"shipping": {"addressInfo": { "country": { "A2": "..." }}}

a2

O

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.

sdFirstName

"shipping": {"consumer": { "firstName": "..." }}

ans..30

C

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

sdLastName

"shipping": {"consumer": { "lastName": "..." }}

ans..30

C

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

sdEmail

"shipping": {"contactInfo": { "email": "..." }}

ans..80

C

E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

Muss @ und Domain enthalten.

sdCompany

"shipping": {"business": { "companyLegalName": "..." }}

ans..200

C

Firmenname, Pflichtparameter für B2B, muss identisch sein mit bdCompany.

sdRegion

"shipping": {"addressInfo": { "region": "..." }}

ans..40

O

Gebiet

sdTitle

"shipping": {"consumer": { "salutation": "..." }}

ans..20

O

Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.

sdStreet

"shipping": {"addressInfo": { "addressLine1": {"street+streetNumber": "..." }}}

a..32

C

Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

Erlaubte Sonderzeichen: -'´‘",.:;#&/()+@ °ºᵃª_ \

sdZip

"shipping": {"addressInfo": { "postalCode": "..." }}

n..5

C

Postleitzahl. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

sdCity

"shipping": {"addressInfo": { "city": "..." }}

a..32

C

Ort. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

sdAddressAddition

"shipping": {"addressInfo": { "addressLine2": "..." }}

ans..60

O

Zusätzliche/ergänzende Adresszeile

Language

"language": "..."

a2

M

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

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

UserData

"metadata[userData]": "..."

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

IPAddr

"browserInfo": {"ipAddress": "..."}

ans..15

O

IP-Adresse des Clients im Format IPv4 oder IPv6

Account

"payment": {"klarna": { "accountName": "..." }}

ans..12

M

Im Paygate können mehrere Klarna-Benutzernamen auf einer MerchantID hinterlegt und durch den Parameter Account angesteuert werden. Standardmäßig verwenden Sie bitte den Wert "0", bei mehreren Klarna-Accounts stimmen Sie die Werte bitte mit Computop Helpdesk ab.

ArticleList

"order": {"items": "..."}

ans..2048

M

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, wenn total_tax_amount oder Parameter TaxAmount angegeben ist.)

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, wenn tax_rate oder Parameter TaxAmount angegeben ist.)

type= Typ der Artikelposition. Mögliche Werte sind <physical>, <discount>, <shipping_fee>, <sales_tax>, <digital>, <gift_card>, <store_credit>, <surcharge>

1
{
2
	"order_lines": [
3
		{
4
			"image_url": "https://www.exampleobjects.com/logo.png",
5
			"merchant_data": "",
6
			"name": "Battery Power Pack",
7
			"product_identifiers": {
8
				"brand": "Intel",
9
				"category_path": "Electronics Store > Computers & Tablets > Desktops",
10
				"global_trade_item-number": "735858293167",
11
				"manufacturer_part_number": "BOXNUC5CPYH"
12
			},
13
			"product_url": "https://www.estore.com/products/f2a8d7e34",
14
			"quantity": 1,
15
			"quantity_unit": "kg",
16
			"reference": "19-402-USA",
17
			"tax_rate": 0,
18
			"total_amount": 1000,
19
			"total_discount_amount": 0,
20
			"total_tax_amount": 0,
21
			"type": "physical",
22
			"unit_price": 1000
23
		}
24
	]
25
}

Anschließend muss die im JSON-Format erstellte Artikelliste Base64 encodiert werden.

EnhancedData

"payment": {"klarna": { "enhancedData": "..." }}

ans..2048

O

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.

1
{
2
	"marketplace_seller_info": [
3
		{
4
			"product_category": "Women's Fashion",
5
			"product_name": "Women Sweatshirt"
6
		}
7
	]
8
}

Anschließend müssen die im JSON-Format erstellten Zusatzinformationen Base64 encodiert werden.

Layout

"payment": {"klarna": { "layout": "..." }}

ans..2048

O

Layout-Parameter für die Klarna-HPP. Dieser Parameter muss im JSON-Format erstellt werden.

1
{
2
  "options": {
3
    "payment_method_category": "PAY_LATER",
4
    "show_subtotal_detail": "HIDE"
5
  }
6
}

Anschließend müssen die im JSON-Format erstellten Layout-Parameter Base64 encodiert werden.

Folgende Klarna-Parameter werden unterstützt:

• payment_method_category (steuert die auf der HPP anzuzeigende Zahlungsart)

• payment_method_categories (steuert die auf der HPP anzuzeigenden Zahlungsarten)

• show_subtotal_detail (blendet die Artikelpositionen auf der HPP aus)

• logo_url (steuert das auf der HPP anzuzeigende Logo)

• page_title (steuert den auf der HPP anzuzeigenden Titel)

Order

"payment": {"klarnaHpp": { "automaticOrderCreation": "..." }}

ans..6

O

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 Paygate nutzen (Request-Parameter muss nicht gesendet werden), wenden Sie sich bitte direkt an den Computop Merchant Service (Computop Vertrieb) und unser Team wird für Sie die benötigte Einstellung direkt am Account hinterlegen.

URLSuccess

"urls": {"success": "..."}

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

• Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

• Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

URLFailure

"urls": {"failure": "..."}

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

• Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

• Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Response

–––

a7

O

Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.

URLNotify

"urls": {"notify": "..."}

ans..256

O

Vollständige URL, die das Paygate 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 Computop also auch bei Klarna freigeschaltet sein. Die URLNotify kann auch bei Computop hinterlegt werden.

Personendaten des Kunden

DateOfBirth

"billing": {"consumer": { "birthdate": "..." }}

dttm

O

Geburtsdatum im Format JJJJ-MM-TT

Gender

"billing": {"consumer": { "gender": "..." }}

a..15

O

Geschlecht <female> für weiblich, <male> für männlich

Title

"billing": {"consumer": { "salutation": "..." }}

a..12

O

Anrede

SocialSecurityNumber

"billing": {"consumer": { "socialSecurityNumber": "..." }}

a..5

O

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

"billing": {"consumer": { "consumerId": "..." }}

ans..15

O

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

"payment": {"klarna": { "legalForm": "..." }}

ans..50

C

Firmentyp. Pflichtparameter für B2B. 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

"billing": {"business": { "companyRegistrationNumber": "..." }}

ans..15

O

Bei Unternehmen: Handelsregisternummer, nur für B2B von Bedeutung, aber kein Pflichtparameter.

CompanyOrPerson

a2

O

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

"payment": {"klarna": { "vatId": "..." }}

ans..15

O

Umsatzsteuer-Identifikationsnummer, nur für B2B von Bedeutung, aber kein Pflichtparameter.

REST

Format

CND

Beschreibung

"paymentId": "..."

an32

M

Kann "00000000000000000000000000000000" lauten, wenn dies noch nicht vom Paygate festgelegt wurde

"_Links.self.type": "..."

an..20

M

"application/json"

"_Links.redirect.href": "..."

an..1024

M

Der Händler muss den Kunden zu dieser URL weiterleiten, um die Zahlung abzuschließen

"_Links.redirect.type": "..."

an..20

M

"text/html"

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

n1..8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes). Code "0": Führen Sie nun die Autorisierung über das Klarna Widget im Frontend durch.

BillingAgreementID

ans..50

O

Token-ID (Consumer Token) von Klarna, welche bei wiederkehrenden Zahlungen (Recurring) mitgesendet werden muss. Der Wert wird nur zurückgegeben, wenn der Aufruf mit RTF=I erfolgt ist.

CodeExt

ans..50

O

Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..1024

O

Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen

TokenExt

ans..36

M

Autorisierungs-Token, der für die Auftragsanlage benötigt wird

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

TaxAmount

"amount": { "taxTotal": ...}

n..10

OC

Gesamtbetrag der MwSt. in der kleinsten Währungseinheit (z.B. EUR Cent). Der Betrag darf nicht negativ sein.

Pflicht, wenn tax_rate und total_tax_amount im Parameter ArticleList angegeben sind.

Hinweis: Die enthaltene MwSt. berechnet sich bei 19% mit der Formel =Bruttopreis / 1,19 * 0,19.

Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

TokenExt

ans..36

M

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.

EventToken

"payment": {"klarna": { "eventType": "..." }}

enum

M

Definiert welcher Klarna API-Call Request angestoßen wird.

Beim Anlegen der Klarna Bestellung muss der Wert CNO übergeben werden.

RTF

–––

a1

O

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.

RequestReason

a..20

O

Beabsichtigte Nutzung des „Consumer Tokens“.

Möglicher Wert ist SUBSCRIPTION.

Note

ans..50

O

Beschreibung für den Zweck des Tokens (z.B. Abo)

ArticleList

"order": {"items": "..."}

ans..2048

M

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, wenn total_tax_amount oder Parameter TaxAmount angegeben ist.)

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, wenn tax_rate oder Parameter TaxAmount angegeben ist.)

type= Typ der Artikelposition. Mögliche Werte sind <physical>, <discount>, <shipping_fee>, <sales_tax>, <digital>, <gift_card>, <store_credit>, <surcharge>

1
{
2
	"order_lines": [
3
		{
4
			"image_url": "https://www.exampleobjects.com/logo.png",
5
			"merchant_data": "",
6
			"name": "Battery Power Pack",
7
			"product_identifiers": {
8
				"brand": "Intel",
9
				"category_path": "Electronics Store > Computers & Tablets > Desktops",
10
				"global_trade_item-number": "735858293167",
11
				"manufacturer_part_number": "BOXNUC5CPYH"
12
			},
13
			"product_url": "https://www.estore.com/products/f2a8d7e34",
14
			"quantity": 1,
15
			"quantity_unit": "kg",
16
			"reference": "19-402-USA",
17
			"tax_rate": 0,
18
			"total_amount": 1000,
19
			"total_discount_amount": 0,
20
			"total_tax_amount": 0,
21
			"type": "physical",
22
			"unit_price": 1000
23
		}
24
	]
25
}

Anschließend muss die im JSON-Format erstellte Artikelliste Base64 encodiert werden.

bdCountryCode

"billing": {"addressInfo": { "country": { "A2": "..." }}}

a2

M

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.

bdFirstName

"billing": {"consumer": { "firstName": "..." }}

ans..30

C

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

bdLastName

"billing": {"consumer": { "lastName": "..." }}

ans..30

C

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

bdEmail

"billing": {"contactInfo": { "email": "..." }}

ans..80

C

E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

Muss @ und Domain enthalten.

bdCompany

"billing": {"business": { "companyLegalName": "..." }}

ans..200

C

Firmenname, Pflichtparameter für B2B, muss identisch sein mit sdCompany.

bdRegion

"billing": {"addressInfo": { "region": "..." }}

ans..40

O

Gebiet

bdTitle

"billing": {"consumer": { "salutation": "..." }}

ans..20

O

Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.

bdStreet

"billing": {"addressInfo": { "addressLine1": {"street+streetNumber": "..." }}}

a..32

C

Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

Erlaubte Sonderzeichen: -'´‘",.:;#&/()+@ °ºᵃª_ \

bdZip

"billing": {"addressInfo": { "postalCode": "..." }}

n..5

C

Postleitzahl. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

bdCity

"billing": {"addressInfo": { "city": "..." }}

a..32

C

Ort. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.

bdAddressAddition

"billing": {"addressInfo": { "addressLine2": "..." }}

ans..60

O

Zusätzliche/ergänzende Adresszeile

sdCountryCode

"shipping": {"addressInfo": { "country": { "A2": "..." }}}

a2

O

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.

sdFirstName

"shipping": {"consumer": { "firstName": "..." }}

ans..30

C

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

sdLastName

"shipping": {"consumer": { "lastName": "..." }}

ans..30

C

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

sdEmail

"shipping": {"contactInfo": { "email": "..." }}

ans..80

C

E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

Muss @ und Domain enthalten.

sdCompany

"shipping": {"business": { "companyLegalName": "..." }}

ans..200

C

Firmenname, Pflichtparameter für B2B, muss identisch sein mit bdCompany.

sdRegion

"shipping": {"addressInfo": { "region": "..." }}

ans..40

O

Gebiet

sdTitle

"shipping": {"consumer": { "salutation": "..." }}

ans..20

O

Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.

sdStreet

"shipping": {"addressInfo": { "addressLine1": {"street+streetNumber": "..." }}}

a..32

C

Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

Erlaubte Sonderzeichen: -'´‘",.:;#&/()+@ °ºᵃª_ \

sdZip

"shipping": {"addressInfo": { "postalCode": "..." }}

n..5

C

Postleitzahl. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

sdCity

"shipping": {"addressInfo": { "city": "..." }}

a..32

C

Ort. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.

sdAddressAddition

"shipping": {"addressInfo": { "addressLine2": "..." }}

ans..60

O

Zusätzliche/ergänzende Adresszeile

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

"description": "..."

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

TransactionID

an12

O

Referenznummer aus dem Klarna-System

BillingAgreementID

ans..50

O

Token-ID (Consumer Token) von Klarna, welche bei wiederkehrenden Zahlungen (Recurring) mitgesendet werden muss. Der Wert wird nur zurückgegeben, wenn der Aufruf mit RTF=I erfolgt ist.

RedirectURL

"_links.redirect.href": "..."

ans..256

O

Damit Klarna ein Cookie setzen kann, muss der Kunde auf diese URL weitergeleitet werden. Der Kunde bekommt hiervon nichts mit.

CodeExt

"externalErrorCode": ...

ans..50

O

Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen

ErrorText

"errorText": "..."

ans..1024

O

Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

"amount": { "value": ...}

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

TaxAmount

"amount": { "taxTotal": ...}

n..10

OC

Gesamtbetrag der MwSt. in der kleinsten Währungseinheit (z.B. EUR Cent). Der Betrag darf nicht negativ sein.

Pflicht, wenn tax_rate und total_tax_amount im Parameter ArticleList angegeben sind.

Hinweis: Die enthaltene MwSt. berechnet sich bei 19% mit der Formel =Bruttopreis / 1,19 * 0,19.

Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

EventToken

"payment": {"klarna": { "eventType": "..." }}

enum

M

Definiert welcher Klarna API-Call Request angestoßen wird.

Beim Anlegen der Klarna Bestellung muss der Wert CNO übergeben werden.

BillingAgreementID

ans..50

M

Token-ID (Consumer Token) von Klarna, welche bei wiederkehrenden Zahlungen (Recurring) mitgesendet werden muss.

RTF

–––

a1

M

Bei wiederkehrenden Zahlungen (Abos): I = Initialzahlung eines neuen Abos, R = Wiederkehrende Zahlung (Recurring).

Bei diesem Request muss der Wert R übergeben werden.

Account

"payment": {"klarna": { "accountName": "..." }}

ans..12

M

Im Paygate können mehrere Klarna-Benutzernamen auf einer MerchantID hinterlegt und durch den Parameter Account angesteuert werden. Standardmäßig verwenden Sie bitte den Wert "0", bei mehreren Klarna-Accounts stimmen Sie die Werte bitte mit Computop Helpdesk ab.

ArticleList

"order": {"items": "..."}

ans..2048

M

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, wenn total_tax_amount oder Parameter TaxAmount angegeben ist.)

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, wenn tax_rate oder Parameter TaxAmount angegeben ist.)

type= Typ der Artikelposition. Mögliche Werte sind <physical>, <discount>, <shipping_fee>, <sales_tax>, <digital>, <gift_card>, <store_credit>, <surcharge>

1
{
2
	"order_lines": [
3
		{
4
			"image_url": "https://www.exampleobjects.com/logo.png",
5
			"merchant_data": "",
6
			"name": "Battery Power Pack",
7
			"product_identifiers": {
8
				"brand": "Intel",
9
				"category_path": "Electronics Store > Computers & Tablets > Desktops",
10
				"global_trade_item-number": "735858293167",
11
				"manufacturer_part_number": "BOXNUC5CPYH"
12
			},
13
			"product_url": "https://www.estore.com/products/f2a8d7e34",
14
			"quantity": 1,
15
			"quantity_unit": "kg",
16
			"reference": "19-402-USA",
17
			"tax_rate": 0,
18
			"total_amount": 1000,
19
			"total_discount_amount": 0,
20
			"total_tax_amount": 0,
21
			"type": "physical",
22
			"unit_price": 1000
23
		}
24
	]
25
}

Anschließend muss die im JSON-Format erstellte Artikelliste Base64 encodiert werden.

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

"description": "..."

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

TransactionID

an12

O

Referenznummer aus dem Klarna-System

CodeExt

"externalErrorCode": ...

ans..50

O

Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen

ErrorText

"errorText": "..."

ans..1024

O

Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

EventToken

"payment": {"klarna": { "eventType": "..." }}

enum

M

Definiert, welcher Klarna API-Call Request angestoßen wird.

Für das Update der Rechnungs- und/oder Lieferadresse muss der Wert UCA übergeben werden.

Rechnungsadresse

bdTitle

"billing": {"consumer": { "salutation": "..." }}

a..12

O

Anrede

bdFirstName

"billing": {"consumer": { "firstName": "..." }}

ans..30

O

Vorname.

Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''.

bdLastName

"billing": {"consumer": { "lastName": "..." }}

ans..30

O

Nachname.

Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''.

bdCompany

"billing": {"business": { "companyLegalName": "..." }}

ans..30

O

Firma. Nur für B2B von Bedeutung, muss identisch sein mit sdCompany.

bdStreet

"billing": {"addressInfo": { "addressLine1": {"street+streetNumber": "..." }}}

a..32

O

Straße und Hausnummer.

Erlaubte Sonderzeichen: -'´‘",.:;#&/()+@ °ºᵃª_ \

bdAddressAddition

"billing": {"addressInfo": { "addressLine2": "..." }}

ans..50

O

Adresszusatz

bdZip

"billing": {"addressInfo": { "postalCode": "..." }}

n..5

O

Postleitzahl

bdCity

"billing": {"addressInfo": { "city": "..." }}

a..32

O

Ort

bdRegion

"billing": {"addressInfo": { "region": "..." }}

a..32

O

Region

bdCountryCode

"billing": {"addressInfo": { "country": { "A2": "..." }}}

a2

O

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.

bdEmail

"billing": {"contactInfo": { "email": "..." }}

ans..80

O

E-Mail-Adresse.

Muss @ und Domain enthalten.

bdPhone

"billing": {"contactInfo": { "phone": "..." }}

n..20

O

Telefon- oder Mobilfunknummer

Lieferadresse

sdTitle

"shipping": {"consumer": { "salutation": "..." }}

a..12

O

Anrede

bdFirstName

"billing": {"consumer": { "firstName": "..." }}

ans..30

O

Vorname.

Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''.

sdLastName

"shipping": {"consumer": { "lastName": "..." }}

ans..30

O

Nachname.

Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''.

sdCompany

"shipping": {"business": { "companyLegalName": "..." }}

ans..50

O

Firma. Nur für B2B von Bedeutung, muss identisch sein mit bdCompany.

sdStreet

"shipping": {"addressInfo": { "addressLine1": {"street+streetNumber": "..." }}}

a..32

O

Straße und Hausnummer.

Erlaubte Sonderzeichen: -'´‘",.:;#&/()+@ °ºᵃª_ \

sdAddressAddition

"shipping": {"addressInfo": { "addressLine2": "..." }}

ans..50

O

Adresszusatz

sdZip

"shipping": {"addressInfo": { "postalCode": "..." }}

n..5

O

Postleitzahl

sdCity

"shipping": {"addressInfo": { "city": "..." }}

a..32

O

Ort

sdRegion

"shipping": {"addressInfo": { "region": "..." }}

a..32

O

Region

sdCountryCode

"shipping": {"addressInfo": { "country": { "A2": "..." }}}

a2

O

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.

sdEmail

"shipping": {"contactInfo": { "email": "..." }}

ans..80

O

E-Mail-Adresse.

Muss @ und Domain enthalten.

sdPhone

"shipping": {"contactInfo": { "phone": "..." }}

n..20

O

Telefon- oder Mobilfunknummer

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

"description": "..."

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

CodeExt

"externalErrorCode": ...

ans..50

O

Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen

ErrorText

"errorText": "..."

ans..1024

O

Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

EventToken

"payment": {"klarna": { "eventType": "..." }}

enum

M

Definiert, welcher Klarna API-Call Request angestoßen wird.

Für das Update der eindeutigen Referenznummer muss der Wert UMR übergeben werden.

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

mid

"merchantId": "..."

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

"xId": "..."

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

"description": "..."

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

"code": ...

an8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

CodeExt

"externalErrorCode": ...

ans..50

O

Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen

ErrorText

"errorText": "..."

ans..1024

O

Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen

MerchantID

BasicAuth.Username

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

"paymentId": "..."

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

"transactionId": "..."

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

"referenceNumber": "..."

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

"amount": { "value": ...}

n..10

M

Neuer Gesamtbetrag in der kleinsten Währungseinheit (z.B. EUR Cent). Der Betrag darf nicht negativ sein.

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Hinweis: Der neue Betrag darf nicht höher sein, als der im anfänglichen Request mitgegebene Betrag.

Currency

"amount": { "currency": "..."}

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

–––

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

EventToken

"payment": {"klarna": { "eventType": "..." }}

enum

M

Definiert, welcher Klarna API-Call Request angestoßen wird.

Für das Ändern des Bestellbetrages und der Artikelliste muss der Wert UEO übergeben werden.

ArticleList

"order": {"items": "..."}

ans..2048

M

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)