Über Klarna Payments
Allgemeines zu Klarna Payments
Klarna bietet drei verschiedene Zahlungsarten in der neuen Klarna KP API über Computop 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.
Hinweis: Alle drei Zahlungsarten sind, mit Einschränkungen der abgesicherten Lastschrift, in den folgenden Ländern in der jeweiligen Landeswährung verfügbar: Deutschland, Österreich, Niederlande, Dänemark, Schweden, Norwegen, Finnland, Großbritannien, USA, Schweiz, Australien, Belgien, Spanien, Italien, Irland, Polen, Portugal, Frankreich und Kanada.
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.
Diagramm zum Prozessablauf Direktanbindung
Prozessablauf Klarna Payments Direktanbindung
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.
Paygate-Schnittstelle
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) CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Datenformate
Format Beschreibung Abkürzungen
Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
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, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/KlarnaPayments.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | 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. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
TaxAmount | 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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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>, Polen <PL>, <PT> Portugal, <FR> Frankreich und <CA> Kanada. |
| bdFirstName | 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 | 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 | 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 | 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>, Polen <PL>, <PT> Portugal, <FR> Frankreich und <CA> Kanada. |
| sdFirstName | 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 | 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 | 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 | 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. Erlaubte Sonderzeichen: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| 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 |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| UserData | ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| IPAddr | ans..39 | O | IP-Adresse des Clients im Format IPv4 oder IPv6 |
| Account | 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 | 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> 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 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 | 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). Für B2B-Transaktionen hat dieser Parameter keine Bedeutung. |
| Key | Format | CND | 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 | C | Firmentyp. Pflichtparameter für B2B. Folgende Werte sind möglich:
|
| 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
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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
Key | Format | CND | Beschreibung |
|---|---|---|---|
Status | a..50 | M | AUTHORIZE_REQUEST (URLSuccess) und FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| UserData | ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop. |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
| 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 | ans..50 | O | Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk 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 | M | Vom Kunden ausgewählte Klarna-Zahlungsart. Mögliche Werte sind Sofort bezahlen (pay_now, direct_debit und 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. | |
Rückgabe-Parameter für Anlagen einer Session mit Klarna Payments
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:
Nach erfolgreicher Autorisierung erhalten Sie einen Autorisierungs-Token (TokenExt), der für die Auftragsanlage benutzt werden muß.
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | 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. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
TaxAmount | 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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| Capture | ans..6 | O | Aktiviert die automatische Buchung einer Bestellung. Bei Verwendung dieses Parameters ist keine explizite Buchungsanfrage erforderlich. Einzig möglicher Wert: AUTO. Wenn Sie die automatische Buchung direkt über das Paygate nutzen möchten (Anfrageparameter muss nicht gesendet werden), wenden Sie sich bitte direkt an Computop Vertrieb. Unser Team wird die erforderliche Einstellung direkt in Ihrem Konto hinterlegen. |
| 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. |
| Note | ans..50 | O | Beschreibung für den Zweck des Abonnements (z.B. Abo) |
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>, Polen <PL>, <PT> Portugal, <FR> Frankreich und <CA> Kanada. |
| bdFirstName | 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 | 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 | 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 | ans..200 | C | Firmenname, Pflichtparameter für B2B, muss identisch sein mit sdCompany. |
| 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. |
| 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>, Polen <PL>, <PT> Portugal, <FR> Frankreich und <CA> Kanada. |
| sdFirstName | 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 | 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 | 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 | 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. Erlaubte Sonderzeichen: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| 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 |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| UserData | ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| IPAddr | ans..39 | O | IP-Adresse des Clients im Format IPv4 oder IPv6 |
| Account | 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 | 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> 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-HPP. Dieser Parameter muss im JSON-Format erstellt werden. Beispiel: {
"options": {
"payment_method_category": "PAY_LATER",
"show_subtotal_detail": "HIDE"
}
}
Anschließend müssen die im JSON-Format erstellten Layout-Parameter Base64 encodiert werden. Folgende Klarna-Parameter werden unterstützt:
|
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=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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| URLSuccess | 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.
|
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| URLFailure | 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.
|
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| URLNotify | 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 | enum | O | 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). Für B2B-Transaktionen hat dieser Parameter keine Bedeutung. |
| Key | Format | CND | 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 | C | Firmentyp. Pflichtparameter für B2B. Folgende Werte sind möglich:
|
| 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 das Aufrufen der Klarna HPP
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an 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: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| UserData | ans..1024 | O | Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
| 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 | |
Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure
Klarna Express Checkout
Für Klarna Express Checkout (KEC) müssen Sie die Klarna-Sitzung über Klarnas JavaScript SDK (siehe Klarna) initiieren. Als Antwort auf Ihren Autorisierungsaufruf erhalten Sie ein Autorisierungstoken, das als TokenExt verwendet werden muss, um eine Bestellung über das Paygate anzulegen (siehe Bestellung bei Klarna anlegen weiter unten).
Bitte beachten Sie: Wenn Sie den Autorisierungsparameter "collect_shipping_address:true" verwenden (Standard ist false), müssen Sie beim Anlegen der Bestellung dieselbe Lieferadresse angeben! Wenn Sie den Autorisierungsparameter "collect_shipping_address:false" verwenden und keine Lieferadresse angeben, muss beim Anlegen der Bestellung keine Lieferadresse angegeben werden.
Bestellung bei Klarna anlegen
Um die Bestellung im Klarna-System über eine Server-zu-Server-Verbindung anzulegen, verwenden Sie bitte folgende URL:
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
| PayID | an32 | C | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. Da die Sitzung beim Klarna Express Checkout nicht über das Paygate angelegt wurde, ist dem Paygate noch keine PayID zugewiesen. In diesem Fall müssen Sie keine PayID angeben. Die PayID wird vom Paygate beim Anlegen der Bestellung zugewiesen. | |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | 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. |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
| TaxAmount | 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. | |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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. |
| Capture | ans..6 | O | Aktiviert die automatische Buchung einer Bestellung. Bei Verwendung dieses Parameters ist keine explizite Buchungsanfrage erforderlich. Einzig möglicher Wert: AUTO. Wenn Sie die automatische Buchung direkt über das Paygate nutzen möchten (Anfrageparameter muss nicht gesendet werden), wenden Sie sich bitte direkt an Computop Vertrieb. Unser Team wird die erforderliche Einstellung direkt in Ihrem Konto hinterlegen. |
| 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. |
| Note | ans..50 | O | Beschreibung für den Zweck des Abonnements (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 = 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> 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 | C | 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. Optional – wenn angegeben, müssen alle Parameter bdCountryCode, bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden. |
| bdFirstName | ans..30 | C | Vorname. Optional – wenn angegeben, müssen alle Parameter bdCountryCode, 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 | ans..30 | C | Nachname. Optional – wenn angegeben, müssen alle Parameter bdCountryCode, 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 | ans..80 | C | E-Mail-Adresse. Optional – wenn angegeben, müssen alle Parameter bdCountryCode, bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden. Muss @ und Domain enthalten. |
| 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 bdCountryCode, bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden. Erlaubte Sonderzeichen: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| bdZip | n..5 | C | Postleitzahl. Optional – wenn angegeben, müssen alle Parameter bdCountryCode, bdFirstName, bdLastName, bdEmail, bdStreet, bdZip, bdCity übergeben werden. |
| bdCity | a..32 | C | Ort. Optional – wenn angegeben, müssen alle Parameter bdCountryCode, 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>, Polen <PL>, <PT> Portugal, <FR> Frankreich und <CA> Kanada. |
| sdFirstName | 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 | 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 | 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 | 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. Erlaubte Sonderzeichen: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| 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 |
Parameter zum Anlegen einer Bestellung bei Klarna
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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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 Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter beim Anlegen einer Bestellung bei Klarna
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | 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. |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
| TaxAmount | 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. | |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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. | |
Capture | ans..6 | O | Aktiviert die automatische Buchung einer Bestellung. Bei Verwendung dieses Parameters ist keine explizite Buchungsanfrage erforderlich. Einzig möglicher Wert: AUTO. Wenn Sie die automatische Buchung direkt über das Paygate nutzen möchten (Anfrageparameter muss nicht gesendet werden), wenden Sie sich bitte direkt an Computop Vertrieb. Unser Team wird die erforderliche Einstellung direkt in Ihrem Konto hinterlegen. | |
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 | 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 | 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> 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 codiert werden. | |
Parameter für eine wiederkehrende Bestellung (Abo) mit 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
TransactionID | an12 | O | Referenznummer aus dem Klarna-System | |
CodeExt | ans..50 | O | Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter für eine wiederkehrende Bestellung (Abo) mit Klarna Payments
Lieferadresse ändern
Die Lieferdaten sind im Klarna-Widget übergeben worden. Solange noch keine Buchung erfolgt ist, kann die Lieferadresse nachträglich angepasst werden. Hierzu verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/KlarnaPayments.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
| 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. | |
| Key | Format | CND | Lieferadresse | |
| sdTitle | a..12 | O | Anrede | |
| sdFirstName | ans..30 | O | Vorname. Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''. | |
| sdLastName | ans..30 | O | Nachname. Darf nicht nur aus Zahlen bestehen und muss aus mehr als 1 Zeichen bestehen. Erlaubte Sonderzeichen: -''. | |
| sdCompany | ans..50 | O | Firma. Nur für B2B von Bedeutung, muss identisch sein mit bdCompany. | |
| sdStreet | a..32 | O | Straße und Hausnummer. Erlaubte Sonderzeichen: -'´`",.:;#&/()+@ °ºᵃª_ \ | |
| sdAddressAddition | 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>, Polen <PL>, <PT> Portugal, <FR> Frankreich und <CA> Kanada. | |
| sdEmail | ans..80 | O | E-Mail-Adresse. Muss @ und Domain enthalten. | |
| sdPhone | n..20 | O | Telefon- oder Mobilfunknummer | |
Parameter für eine Adressänderung 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
CodeExt | ans..50 | O | Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter für eine Adressänderung bei Klarna Payments
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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. | |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Parameter für Änderung der Referenznummer 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
CodeExt | ans..50 | O | Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter für Änderung der Referenznummer bei Klarna Payments
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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. | |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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%). 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> 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
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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
CodeExt | ans..50 | O | Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter für Änderung von Bestellbetrag und Artikelliste bei Klarna Payments
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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ährung, drei Zeichen DIN / ISO 4217, zulässig sind: AUD, CHF, DKK, EUR, GBP, NOK, SEK, USD. | |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| ReqId | ans..32 | O | Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
ShippingData | ans..2048 | O | Lieferinformationen (z.B. Tracking-Daten). Dieser Parameter muss im JSON-Format erstellt werden. Beispiel: {
"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%). 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> 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>. Wurde der Auftrag vollständig gebucht, führt dieser Parameter zu einem Fehler, da ein Restbetrag von 0 nicht storniert werden kann. |
Parameter für Buchungen 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
| 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 Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter für Buchungen bei Klarna Payments
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
CodeExt | ans..50 | O | Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter für erneutes Versenden einer aktivierten Rechnung bei Klarna Payments
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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ährung, drei Zeichen DIN / ISO 4217, zulässig sind: AUD, CHF, DKK, EUR, GBP, NOK, SEK, USD. | |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| ReqId | ans..32 | O | Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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%). 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> 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. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Parameter für Gutschrift von Zahlungen mit 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
| InvoiceNr | ans..30 | M | Rechnungs-/Gutschriftsnummer von Klarna Payments | |
CodeExt | ans..50 | O | Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter für Gutschrift von Zahlungen mit Klarna Payments
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 Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
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 Helpdesk, 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ährung, drei Zeichen DIN / ISO 4217, zulässig sind: AUD, CHF, DKK, EUR, GBP, NOK, SEK, USD. | |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| ReqId | ans..32 | O | Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Parameter für Storno von Zahlungen mit 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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
CodeExt | ans..50 | O | Fehlercode von Klarna, wenn mit Computop Helpdesk abgesprochen | |
ErrorText | ans..1024 | O | Fehlertext von Klarna, wenn mit Computop Helpdesk abgesprochen | |
Rückgabe-Parameter für Storno von Zahlungen mit Klarna Payments
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:
Action | Version | Beschreibung |
|---|---|---|
| Capture | 1.0 / 2.0 | Standardversion ohne Rückgabe von Parameter 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 Parameter 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 Parameter Code |
| 1.x / 2.x | 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> 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, KLARNAPM für Klarna Payments |
Action | a..20 | M | Der Action-Parameter definiert die Art der Transaktion: Capture (Buchung) Credit (Gutschrift) Reverse (Storno) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | 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. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, zulässig sind: AUD, CHF, DKK, EUR, GBP, NOK, SEK, USD. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für diese Transaktion |
Key | Format | CND | Beschreibung |
|---|---|---|---|
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>,<Status>,<Code> KLARNAPM,CAPTURE,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ArticleList>,<InvNo>,<Status>,<Code> KLARNAPM,CREDIT,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code> KLARNAPM,CREDIT,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<ArticleList>,<InvNo>,<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) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für diese Transaktion |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien