1 Über Klarna Payments

1.1 Allgemeines zu Klarna Payments

Logo

Info	Typ
Das 1cs Online Bezahlsystem 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.	Gemischte Zahlarten

Klarna bietet drei verschiedene Zahlungsarten in der neuen Klarna KP API über Die First Cash Solution an: Rechnungs- und Ratenkauf (Pay Later & Pay over time) sowie Sofort + abgesicherte Lastschrift (Pay Now). Dafür brauchen Sie während der Bestellung nur alle Rechnungsdaten an den Dienstleister zu übergeben. Dieser übernimmt dann den gesamten Aufwand der Rechnungsstellung und des nachgelagerten Debitorenmanagements. Als Händler bekommen Sie eine Zahlungsgarantie; egal welche Bezahlmöglichkeit ihr Kunde wählt. Dadurch erhalten Ihre Kunden mit Klarna finanzielle Flexibilität, denn sie können selbst flexibel zwischen Rechnungskauf oder Ratenkauf wählen. Beim Ratenkauf können Sie zudem die Höhe der Raten und Rückzahlungstermine selbst bestimmen. Die Rechnungslösung können sie auch für ihren B2B Handel einsetzen.

Der Ratenkauf im Online-Shop motiviert Ihre Kunden, hochwertige Warenkörbe zu bestellen. So erhöht sich auch Ihr Umsatz. Klarna gewährt im Bestellprozess sekundenschnell eine Online-Zusage für den Ratenkauf. Ein PostIdent-Verfahren ist nicht nötig. Klarna zahlt den Rechnungsbetrag kurzfristig an den Händler aus und trägt das Ausfallrisiko selbst. Als Händler profitieren Sie von schnell verfügbarer Liquidität.

Alle drei Zahlungsarten sind, mit Einschränkungen der abgesicherten Lastschrift, in den folgenden Ländern in der jeweiligen Landeswährung verfügbar: Dänemark (DKK), Deutschland (EUR), Finnland (EUR), Großbritannien (GBP), Niederlande (EUR), Norwegen (NOK), Österreich (EUR), Schweden (SEK) und USA (USD).

Weitere Informationen finden Sie auch auf der Webseite von Klarna (https://www.klarna.de).

Klarna Payments unterscheidet zwischen einer Direktanbindung und der Klarna Hosted Payment Page (HPP).

Hinweis zur Buchung

Bitte beachten Sie, dass die Buchung (capture.aspx) manuell erfolgen muss, um die Zahlung durchzuführen und den Geldfluss zu initiieren.

1.2 Diagramm zum Prozessablauf Direktanbindung

Prozessablauf Klarna Payments Direktanbindung

1.3 Diagramm zum Prozessablauf HPP

 

Prozessablauf Klarna Payments HPP

Mit der Direktanbindung wird für jede Zahlungsart ein separates Widget per JavaScript eingebunden. Bei der HPP wird eine komplette Checkout-Seite angezeigt, auf der alle oder nur einige ausgewählte Zahlungsarten angezeigt werden. Sowohl die Widgets, als auch die HPP werden von einem Klarna-Server geladen.

2 1cs Online Bezahlsystem Schnittstelle

2.1 Definitionen

2.1.1 Datenformate

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)

2.1.2 Abkürzungen

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

Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.

2.2 Klarna Session für die Direktanbindung erzeugen

Bevor die Klarna Widgets geladen werden können, muss eine Klarna Session erzeugt werden, die einen AccessToken zurückgibt. Dieser AccessToken wiederum muß zum Laden der Widgets benutzt werden. Um eine Session mit Klarna über eine Server-zu-Server-Verbindung zu beginnen, rufen Sie folgende URL auf:

https://www.computop-paygate.com/KlarnaPayments.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr	ns..30	O	Eindeutige Referenznummer des Händlers. Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
TaxAmount	n..10	M	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.
Currency	a3	M	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle
bdCountryCode	a2	M	Ländercode der Rechnungsadresse zweistellig gemäß ISO-3166-1. Erlaubt sind derzeit 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> und Polen <PL>
bdFirstName	ans..30	C	Vorname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdLastName	ans..30	C	Nachname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdEmail	ans..80	C	E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdCompany	ans..200	C	Firmenname, Pflichtparameter für B2B, muss identisch sein mit sdCompany.
bdRegion	ans..40	O	Gebiet
bdTitle	ans..20	O	Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.
bdStreet	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	n..5	C	Postleitzahl. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdCity	a..32	C	Ort. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdAddressAddition	ans..60	O	Zusätzliche/ergänzende Adresszeile
sdCountryCode	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> und Polen <PL>
sdFirstName	ans..30	O	Vorname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdLastName	ans..30	O	Nachname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdEmail	ans..80	O	E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdCompany	ans..200	C	Firmenname, Pflichtparameter für B2B, muss identisch sein mit bdCompany.
sdRegion	ans..40	O	Gebiet
sdTitle	ans..20	O	Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.
sdStreet	a..32	O	Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdZip	n..5	O	Postleitzahl. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdCity	a..32	O	Ort. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdAdressAddition	ans..60	O	Zusätzliche/ergänzende Adresszeile
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)
IPAddr	ans..15	M	IP-Adresse des Clients im Format IPv4 oder IPv6
Account	ans..12	M	Bei der First Cash Solution 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 dem First Cash Solution Support abgestimmt werden.
ArticleList	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%). 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>   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.
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. Beispiel: {     “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-Parameter für die Klarna-Widgets. Dieser Parameter muss im JSON-Format erstellt werden. Beispiel: {     “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.
URLConfirm	ans..256	M	Finale Bestellbestätigungs-URL, auf die Klarna den Kunden leitet, nachdem die Bestellung im Klarna-System erfolgreich angelegt wurde
URLNotify	ans..256	O	Vollständige URL, die das 1cs Online Bezahlsystem aufruft, um den Shop zu benachrichtigen. 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 der First Cash Solution, also auch bei Klarna freigeschaltet sein. Die URLNotify kann auch bei der First Cash Solution hinterlegt werden.
PayType	as..32	M	Vom Kunden ausgewählte Klarna Zahlungsart. Mögliche Werte sind Sofort bezahlen (pay_now, direct_debit, direct_bank_transfer und card), Später bezahlen (pay_later) und In Raten bezahlen (pay_over_time).
Persondaten des Kunden
DateOfBirth	dttm	O	Geburtsdatum im Format JJJJ-MM-TT
Gender	a..15	O	Geschlecht <female> für weiblich, <male> für männlich
Title	a..12	O	Anrede
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	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	ans..50	c	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	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	ans..15	O	Umsatzsteuer-Identifikationsnummer, nur für B2B von Bedeutung, aber kein Pflichtparameter.

Parameter für Anlegen einer Session mit Klarna Payments

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien
XID	an32	M	Vom 1cs Online Bezahlsystem 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 Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Status	a..50	M	AUTHORIZE_REQUEST (URLSuccess) und 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äß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen
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	enum	O	Vom Kunden ausgewählte Klarna Zahlungsart. Mögliche Werte sind Sofort bezahlen (pay_now, direct_debit, direct_bank_transfer und card), Später bezahlen (pay_later) und In Raten bezahlen (pay_over_time). Der zurückgegebene Wert entscheidet darüber, welche Widgets geladen werden dürfen.

Rückgabe-Parameter für Anlagen einer Session mit Klarna Payments

2.3 Klarna Widgets anzeigen

Klarna verwendet Widgets, um dem Kunden die möglichen Zahlungsarten anzuzeigen. Die zur Auswahl stehenden Zahlungsarten ergeben sich aus der zuvor ausgewählten Kategorie (siehe Klarna Session erzeugen, PayType). Die Einbindung der Widgets erfolgt mithilfe des AccessToken (siehe Klarna Session erzeugen, AccessToken) und des Klarna JavaScript SDK. Wie das Klarna JavaScript SDK eingebunden und initialisiert wird und wie die Widgets geladen werden, wird auf der Klarna Webseite beschrieben:

https://developers.klarna.com/documentation/klarna-payments/integration-guide/present-klarna-widget/

Nach erfolgreicher Autorisierung erhalten Sie einen Autorisierungs-Token (TokenExt), der für die Auftragsanlage benutzt werden muß.

2.4 Klarna Session für die HPP erzeugen

Um eine Zahlung über die Klarna HPP abzuwickeln, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/KlarnaPaymentsHPP.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr	ans..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
TaxAmount	n..10	M	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.
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	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> und Polen <PL>
bdFirstName	ans..30	C	Vorname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdLastName	ans..30	C	Nachname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdEmail	ans..80	C	E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdCompany	ans..200	O	Firmenname
bdRegion	ans..40	O	Region
bdTitle	ans..20	O	Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.
bdStreet	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	n..5	C	Postleitzahl. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdCity	a..32	C	Ort. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdAdressAddition	ans..60	O	Zusätzliche/ergänzende Adresszeile
sdCountryCode	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> und Polen <PL>
sdFirstName	ans..30	C	Vorname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdLastName	ans..30	C	Nachname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdEmail	ans..80	C	E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdCompany	ans..200	C	Firmenname, Pflichtparameter für B2B, muss identisch sein mit bdCompany.
sdRegion	ans..40	O	Gebiet
sdTitle	ans..20	O	Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.
sdStreet	a..32	C	Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdZip	n..5	C	Postleitzahl. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdCity	a..32	C	Ort. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdAddressAddition	ans..60	O	Zusätzliche/ergänzende Adresszeile
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)
IPAddr	ans..15	O	IP-Adresse des Clients im Format IPv4 oder IPv6
Account	ans..12	M	Bei der First Cash Solution 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 First Cash Solution Support abgestimmt werden.
ArticleList	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 = Produktmarkeproduct_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 = Herstellernummerproduct_url = URL zum Produktbildquantity_unit = Mengeneinheit (z.B. kg)reference = Artikelnummer (z.B. SKU)tax_rate = Steuersatz in Prozent (z.B. 25%). 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> 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.
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.Beispiel:{    “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-Parameter für die HPP. Dieser Parameter muss im JSON-Format erstellt werden.Beispiel: {    “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	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 mitgesendet werden. Einziger möglicher Wert: AUTO. Möchten Sie das automatische Order processing direkt durch das 1cs OBS nutzen (Request-Parameter muss nicht gesendet werden), wenden Sie sich bitte direkt an den 1cs Merchant Service (1cs Support) und unser Team wird für Sie die benötigte Einstellung direkt am Account hinterlegen.
URLSuccess	ans..256	M	Vollständige URL, die das 1cs Online Bezahlsystem aufruft, wenn die Autorisierung 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 von 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 senden. Überprüfen Sie daher unbedingt den “code”-Wert des DATA-Elements. Nur eine Antwort mit “code=00000000” sollte als erfolgreich angesehen werden.
URLFailure	ans..256	M	Vollständige URL, die das 1cs Online Bezahlsystem 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 von 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	ans..256	O	Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. 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 der 1cs also auch bei Klarna freigeschaltet sein. Die URLNotify kann auch bei der 1cs hinterlegt werden.
Personendaten des Kunden
DateOfBirth	dttm	O	Geburtsdatum im Format JJJJ-MM-TT
Gender	a..15	O	Geschlecht <female> für weiblich, <male> für männlich
Title	a..12	O	Anrede
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	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	ans..50	O	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	Bei Unternehmen: Handelsregisternummerr, 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	ans..15	O	Umsatzsteuer-Identifikationsnummer

Parameter für das Aufrufen der Klarna HPP

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsyste man Ihre URLSuccess, URLFailure und URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format		CND	Beschreibung
MID	ans..30		M	HändlerID, die von der First Cash Solutioon vergeben wird
PayID	an32		M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32		M	Vom 1cs Online Bezahlsystem 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 Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC		an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
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	n8		M	Fehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
CodeExt	ans..50		O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024		O	Fehlertext von Klarna, wenn mit First Cash Solution Support abgesprochen
TokenExt	ans..36		M	Autorisierungs-Token, der für die Auftragsanlage benötigt wird.

Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure

2.5 Bestellung bei Klarna anlegen

Um die Bestellung im Klarna-System über eine Server-zu-Server-Verbindung anzulegen, verwenden Sie bitte folgende URL auf:

https://www.computop-paygate.com/KlarnaPayments.aspx

Handelt es sich um die initiale Bestellung einer wiederkehrenden Bestellung (RTF=I), kann nur die Rechnungsadresse übergeben werden, keine Lieferadresse.

Weichen die Adressdaten von den Adressdaten ab, die bei der Autorisierung aus dem JavaScript-Widget übergeben wurden, wird die Bestellung abgelehnt.

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr	ans..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
TaxAmount	n..10	M	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 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
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	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). Wenn es sich 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	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 = Produktmarkeproduct_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 = Herstellernummerproduct_url = URL zum Produktbildquantity_unit = Mengeneinheit (z.B. kg)reference = Artikelnummer (z.B. SKU)tax_rate = Steuersatz in Prozent (z.B. 25%). 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> 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.
bdCountryCode	a2	M	Ländercode der Rechnungsadresse zweistellig gemäß ISO-3166-1. Erlaubt sind derzeit 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> und Polen <PL>
bdFirstName	ans..30	C	Vorname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdLastName	ans..30	C	Nachname. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdEmail	ans..80	C	E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdCompany	ans..200	C	Firmenname, Pflichtparameter für B2B, muss identisch sein mit sdCompany.
bdRegion	ans..40	O	Gebiet
bdTitle	ans..20	O	Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.
bdStreet	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	n..5	C	Postleitzahl. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdCity	a..32	C	Ort. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
bdAddressAddition	ans..60	O	Ort. Optional – wenn angegeben, müssen alle Parameter bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden.
sdCountryCode	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> und Polen <PL>
sdFirstName	ans..30	O	Vorname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdLastName	ans..30	O	Nachname. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdEmail	ans..80	O	E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdCompany	ans..200	C	Firmenname, Pflichtparameter für B2B, muss identisch sein mit bdCompany.
sdRegion	ans..40	O	Gebiet
sdTitle	ans..20	O	Titel des Kunden oder der Kontaktperson, z.B. Dr. oder Prof.
sdStreet	a..32	O	Straße und Hausnummer. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdZip	n..5	O	Postleitzahl. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdCity	a..32	O	Ort. Optional – wenn angegeben, müssen alle Parameter sdFirstName, sdLastName, sdEmail, sdStreet, sdZip, sdCity übergeben werden.
sdAdressAddition	ans..60	O	Zusätzliche/ergänzende Adresszeile

Parameter zum Anlegen einer Bestellung bei Klarna

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem 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	ns..30	M	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
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	n8	M	Fehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (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	ans..256	O	Damit Klarna ein Cookie setzen kann, muss der Kunde auf diese URL weitergeleitet werden. Der Kunde bekommt hiervon nichts mit.
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter beim Anlegen einer Bestellung bei Klarna

2.6 Wiederkehrende Bestellung (Abo) bei Klarna anlegen

Um eine wiederkehrende Bestellung (z.B. Abo) bei Klarna anzulegen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/KlarnaPayments.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr	ans..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amount	n..10	M	Gesamtbetrag der Bestellung in der kleinsten Währungseinheit inkl. Steuern und allen Rabatten (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.
TaxAmount	n..10	M	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.
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	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	ans..12	M	Bei der First Cash Solution können mehrere Klarna 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 dem First Cash Solution Support abgestimmt werden.
ArticleList	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%). 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>   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.

Parameter für eine wiederkehrende Bestellung (Abo) mit Klarna Payments

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem 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 Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
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	n8	M	Fehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
TransactionID	an12	O	Referenznummer aus dem Klarna-System
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter für eine wiederkehrende Bestellung (Abo) mit Klarna Payments

2.7 Rechnungs- und Lieferadresse ändern

Die Rechnungs- und Lieferdaten sind im Klarna-Widget übergeben worden. Solange noch keine Buchung erfolgt ist, können Rechnungs- und/oder Lieferadresse nachträglich angepasst werden. Hierzu verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/KlarnaPayments.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem 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	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	a..12	O	Anrede
bdFirstName	ans..30	O	Vorname
bdLastName	ans..30	O	Nachname
bdCompany	ans..50	O	Firma
bdStreet	a..32	O	Straße und Hausnummer
bdAddressAddition	ans..50	O	Adresszusatz
bdZip	n..5	O	Postleitzahl
bdCity	a..32	O	Ort
bdRegion	a..32	O	Region
bdCountryCode	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> und Polen <PL>
bdEmail	ans..80	O	E-Mail-Adresse
bdPhone	n..20	O	Telefon- oder Mobilfunknummer
Lieferadresse
sdTitle	a..12	O	Anrede
sdFirstName	ans..30	O	Vorname
sdLastName	ans..30	O	Nachname
sdCompany	ans..50	O	Firma
sdStreet	a..32	O	Straße und Hausnummer
sdAddressAdition	ans..50	O	Adresszusatz
sdZip	n..5	O	Postleitzahl
sdCity	a..32	O	Ort
sdRegion	a..32	O	Region
sdCountryCode	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> und Polen <PL>
sdEmail	ans..80	O	E-Mail-Adresse
sdPhone	n..20	O	Telefon- oder Mobilfunknummer

Parameter für eine Adressänderung bei Klarna Payments

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem 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 Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
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	n8	M	Fehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter für eine Adressänderung bei Klarna Payments

2.8 Eindeutige Referenznummer ändern

Solange noch keine Buchung erfolgt ist, kann die eindeutige Referenznummer, die bereits beim Erzeugen der Klarna-Session im Parameter RefNr mitgeschickt wurde, nachträglich angepasst werden. Hierzu verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/KlarnaPayments.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
EventToken	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	ans..30	M	Neue eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Parameter für Änderung der Referenznummer bei Klarna Payments

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem 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 Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
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	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Fehlercodes
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter für Änderung der Referenznummer bei Klarna Payments

2.9 Bestellbetrag und Artikelliste ändern

Solange noch keine Buchung erfolgt ist, können der Bestellbetrag sowie die gesamte Artikelliste nachträglich angepasst werden. Hierzu verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/KlarnaPayments.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
TransID	ans..64	M	Ihr eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr	ans..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amount	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	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	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	ans..2048	M	Neue 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%). 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>   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.

Parameter für Änderung von Bestellbetrag und Artikelliste bei Klarna Payments

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem an ihr System übergibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem 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 Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
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	n8	M	Fehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter für Änderung von Bestellbetrag und Artikelliste bei Klarna Payments

2.10 Buchung

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Voll- oder Teilbuchung (Capture) für Klarna Payments über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/capture.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag, der gebucht werden soll, in der kleinsten Währungseinheit (z.B. EUR Cent) inkl. Steuern und Rabatte. Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. Hinweis: Ob eine Teil- oder Vollbuchung durchgeführt wird, ist vom Betrag abhängig.
Currency	a..3	M	Währungskürzel, drei Zeichen DIN / ISO 4217, zulässig sind: AUD, CHF, DKK, EUR, GBP, NOK, SEK, USD. Hier eine Übersicht: A1 Währungstabelle
RefNr	ns..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
ReqID	ans..32	O	Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.
ShippingData	ans..2048	O	Lieferinformationen (z.B. Tracking-Daten). Dieser Parameter muss im JSON-Format erstellt werden. {     “shipping_info”: [         {             “shipping_company”: “DHL US”,             “shipping_method”: “Home”,             “tracking_number”: “63456415674545679074”,             “tracking_url”: “http://shipping.example/findmypackage?63456415674545679074“,             “return_shipping_company”: “DHL US”,             “return_tracking_number”: “93456415674545679000”,             “return_tracking_url”: “http://shipping.example/findmypackage?93456415674545679000”         }     ] } Anschließend müssen die im JSON-Format erstellten Lieferinformationen Base64 encodiert werden.
ArticleList	ans..2048	O	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%). 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>   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.
CompleteType	a3	O	Mit diesem Parameter kann bei einer Teilbuchung gleichzeitig der noch verbleibende Restbetrag storniert werden. Möglicher Wert <YES>

Parameter für Buchungen bei Klarna Payments

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem an ihr System übergibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem 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	ns..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
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	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem (Fehlercodes)
InvoiceNr	ans..30	M	Rechnungs-/Buchungsnummer von Klarna. Diese Nummer wird beispielsweise benötigt, um das Versenden der E-Mail mit den Zahlungs- und Bestellinformationen erneut anzustoßen.
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter für Buchungen bei Klarna Payments

2.11 Erneutes Versenden einer aktivierten Rechnung

Es kann vorkommen, dass ein Kunde die E-Mail mit den Zahlungs- und Bestellinformationen nicht erhalten hat. Dieser Request kann nur durchgeführt werden, wenn bereits eine Buchung durchgeführt wurde. Um das Versenden dieser E-Mail erneut anzustoßen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/KlarnaPayments.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem 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	enum	M	Definiert, welcher Klarna API-Call Request angestoßen wird. Für das erneute Versenden der E-Mail muss der Wert RCC übergeben werden.
InvoiceNr	ans..30	M	Rechnungs-/Buchungsnummer von Klarna, welche bei jeder Buchung im Antwortparameter InvoiceNr zurückgegeben wird

Parameter für erneutes Versenden einer aktivierten Rechnung bei Klarna Payments

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Parameter	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien
XID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID	ans..64	M	Transaktionsnummer des Händlers
RefNr	ans..30	O	Eindeutige Referenznummer Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
Status	a..50	M	OK oder FAILED
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	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Fehlercodes
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter für erneutes Versenden einer aktivierten Rechnung bei Klarna Payments

2.12 Gutschrift mit Referenz und Teilgutschrift

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Um eine Teil- oder Vollgutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/credit.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Gesamtbetrag, der gutgeschrieben werden soll, in der kleinsten Währungseinheit (z.B. EUR Cent) inkl. Steuern und Rabatten. Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. Hinweis: Ob eine Teil- oder Vollgutschrift durchgeführt wird, ist vom Betrag abhängig.
Currency	a..3	M	Währungskürzel, drei Zeichen DIN / ISO 4217, zulässig sind: AUD, CHF, DKK, EUR, GBP, NOK, SEK, USD. Hier eine Übersicht: A1 Währungstabelle
RefNr	ns..30	O	Eindeutige Referenznummerdes Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
ReqID	ans..32	O	Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.
ArticleList	ans..2048	O	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%). 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>   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
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Parameter für Gutschrift von Zahlungen mit Klarna Payments
 

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem an Ihr System zurückgibt:

Hinweis:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Key	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem 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	ns..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
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	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes
InvoiceNr	ans..30	M	Rechnungs-/Gutschriftsnummer von Klarna Payments
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter für Gutschrift von Zahlungen mit Klarna Payments

2.13 Storno

Stornierungen sind über eine Server-zu-Server-Kommunikation möglich. Mit diesem Aufruf können Sie den gesamten Autorisierungsbetrag, wenn noch keine Buchung erfolgt ist, stornieren oder den verbleibenden Autorisierungsbetrag stornieren, wenn bereits eine Teilbuchung erfolgt ist. Hierzu verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/reverse.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Beschreibung
MerchantID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
TransID	ans..64	M	TransaktionsID, die für jede Zahlung eindeutig sein muss
Amount	n..10	M	Betrag, der storniert werden soll, in der kleinsten Währungseinheit (z.B. EUR Cent) inkl. Steuern und Rabatten. Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. Hinweis: Wenn noch keine Buchung erfolgt ist, muss der Betrag dem vorher autorisierten Betrag entsprechen. Wenn bereits eine Teilbuchung erfolgt ist, muss der Betrag dem Restbetrag der Autorisierung entsprechen. Eine Stornierung auf einem bereits vollständig gebuchtem Auftrag wird mit einem Fehler abgelehnt, auch wenn als Betrag 0 verwendet wird.
Currency	a..3	M	Währungskürzel, drei Zeichen DIN / ISO 4217, zulässig sind: AUD, CHF, DKK, EUR, GBP, NOK, SEK, USD. Hier eine Übersicht: A1 Währungstabelle
RefNr	ans..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
ReqID	ans..32	O	Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.
MAC	an64	M	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Parameter für Storno von Zahlungen mit Klarna Payments  

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem an Ihr System zurückgibt:

Hinweis:

• es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

• die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

Parameter	Format	CND	Beschreibung
MID	ans..30	M	HändlerID, die von der First Cash Solution Support vergeben wird
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XID	an32	M	Vom 1cs Online Bezahlsystem 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	ns..30	O	Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
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	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Fehlercodes
CodeExt	ans..50	O	Fehlercode von Klarna, wenn mit dem First Cash Solution Support abgesprochen
ErrorText	ans..1024	O	Fehlertext von Klarna, wenn mit dem First Cash Solution Support abgesprochen

Rückgabe-Parameter für Storno von Zahlungen mit Klarna Payments

3 Batch-Nutzung der Schnittstelle

Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Zahlung mit Klarna Payments übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Bei Buchung unterscheiden sich die Aufrufe zwischen Komplett- und Teil-Aktivierung. Bei einer Teilbuchung muss zusätzlich die Artikelliste bei <ArticleList> mit übergeben werden. Ebenso ist zusätzlich der Parameter <ArticleList> erforderlich, wenn eine Teil-Gutschrift auf eine Komplett-Aktivierung erfolgt. Bei einer Teil-Gutschrift auf eine Teil-Aktivierung hin sind die beiden Parameter <ArticleList> und <InvNo> zusätzlich erforderlich. Alle Zusatzparameter kommen ebenfalls in der Antwortdatei mit zurück.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Aktion	Version	Beschreibung
Capture	1.0 / 2.0	Standardversion ohne Rückgabe von Code
	1.x / 2.x	mit RefNr (gilt für alle Versionen außer 1.0)
Credit	1.0 / 2.0	Standardversion ohne Rückgabe von Code
	1.x / 2.x	mit RefNr (gilt für alle Versionen außer 1.0)
Reverse	1.0 / 2.0	Standardversion ohne Rückgabe von Code
	1.x / 2x.	mit RefNr (gilt für alle Versionen außer 1.0)

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Zahlung mit Klarna Payments in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

HEAD,<MerchantID>,<Date>,<Version>

KLARNAPM,CAPTURE,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<InvNo> KLARNAPM,CAPTURE,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ArticleList> KLARNAPM,CREDIT,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID> KLARNAPM,CREDIT,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ArticleList> KLARNAPM,REVERSE,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID> FOOT,<CountRecords>,<SumAmount>

Beispiel für Master MID Funktion:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:

Key	Format	CND	Beschreibung
Type	a..11	M	HEAD für Header, FOOT für Footer, KLARNA für Klarna Payments
Action	a..20	M	Der Action-Parameter definiert die Art der Transaktion: Capture (Buchung) Credit (Gutschrift) Reverse (Storno)
Amount	n..10	M	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent) Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currency	a3	M	Währungskürzel, drei Zeichen DIN / ISO 4217, zulässig sind: AUD, CHF, DKK, EUR, GBP, NOK, SEK, USD. Hier eine Übersicht: A1 Währungstabelle
TransID	ans..64	M	TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNr	ns..30	O	eindeutige Referenznummer des Händlers
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für diese Transaktion
InvNo	ans..30	O	Rechnungsnummer für eine Teil-Aktivierung oder Teil-Gutschrift. Längste InvNo bisher war 17stellig.

Beschreibung der Felder im Datensatz von Batch-Dateien

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:

HEAD,<MerchantID>,<Date>,<Version>

KLARNAPM,CAPTURE,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<InvNo>,<Status>,<Code> KLARNAPM,CAPTURE,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ArticleList>,<Status>,<Code> KLARNAPM,CREDIT,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code> KLARNAPM,CREDIT,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ArticleList>,<Status>,<Code> KLARNAPM,REVERSE,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code> FOOT,<CountRecords>,<SumAmount>

Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter, werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):

Key	Format	CND	Beschreibung
Action	a..20	M	Der Action-Parameter definiert die Art der Transaktion: Capture (Buchung) Credit (Gutschrift) Reverse (Storno)
PayID	an32	M	Vom 1cs Online Bezahlsystem vergebene ID für diese Transaktion
Status	a..50	M	OK (URLSuccess) oder FAILED (URLFailure)
Code	n8	M	Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Fehlercodes

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien