Über Sofort

Allgemeines zu Sofort

Dieses Handbuch beschreibt die Einrichtung und Nutzung der Computop-Schnittstelle für Sofort:

  • Projekteinrichtung für Sofort
  • Konfiguration für Sofort Ident
  • Konfiguration für iDEAL
  • Parameter der Schnittstelle


Logo

Info

Die internationale Online-Überweisung mit PIN/TAN der Sofort GmbH ist mittlerweile in 13 Ländern verfügbar. Als Teil der Klarna Group bietet Sofort die Integration der Zahlung in den Webshop an, sodass ein Käufer zu seiner Bank weitergeleitet wird und per PIN- und TAN-Eingabe die Überweisung vornimmt.

TypZahlungen per Onlineüberweisung

Weitere Informationen finden Sie auch auf der Webseite der Sofort unter https://www.klarna.com/de/verkaeufer/.

Sofort hat gleich mehrere Vorteile: Diese Methode ist eine Vorauszahlung, die das Zahlungsziel für den Händler mini­miert. Andererseits nutzt der Kunde das ihm bekannte und vertrauenswürdige Online-Banking seines eigenen Kreditinstitutes – genau wie beim Online-Banking.

Das Computop Paygate unterstützt Sofort der Sofort Gmbh in vielen Ländern europaweit. Die aktuell unterstützten Länder erfahren Sie auf der Webseite https://www.klarna.com/de/verkaeufer/produkte/sofort-bezahlen/.

Sofort zählt zu den Online-Direktüberweisungsverfahren und funktioniert auf Basis des bewährten Online-Banking. Ein großer Vorteil ist: Der Käufer muss sich nicht erst registrieren oder ein virtuelles Konto, ein sogenanntes Wallet, anlegen. Wie der Name schon sagt, handelt es sich um eine sofortige Überweisung, also eine Direktüberweisung. Dazu wählt der Käufer bei seinem Online-Einkauf Sofort als Zahlungsmöglichkeit aus und wird dann auf das gesicherte Zahlformular weitergeleitet. Die Überweisungsdaten werden automatisch übernommen und der Käufer muss nur noch seine Bank wählen sowie seine gewohnten Zugangsdaten für das Online-Banking eingeben. Abschließend gibt er die Überweisung mit einem Bestätigungscode frei. Die Daten werden verschlüsselt an das Online-Banking Konto übermittelt. Der Onlinehändler erhält eine Echtzeitbestätigung über die Eingabe der Überweisung im Online-Banking des Käufers. Daher kann der Händler die Bestellung sofort bearbeiten, versenden und die Waren/Dienstleistungen schneller liefern. Somit entfällt eine Wartezeit bis zum Versand der Waren, wie etwa bei der Vorkasse per Banküberweisung.

In den Niederlanden hat sich iDEAL als Direktüberweisungsverfahren etabliert. Der Ablauf ist ähnlich zu anderen Direktüberweisungsverfahren. Voraussetzung für die Nutzung von iDEAL über Sofort ist ein Businesskonto bei der Deutschen Handelsbank für den Empfang der Zahlungen.

Wie beim Online-Banking üblich, sind auch bei Sofort die übermit­tel­ten Daten mit SSL (Secure Sockets Layer) verschlüsselt.


Diagramm zum Prozessablauf

Prozessablauf für Sofort


Konfiguration für Sofort

Als Online-Anbieter richten Sie zuerst einen Account bei Sofort ein auf der Webseite: https://www.sofort.com/payment/users/register/529.

Beginnen Sie dann mit der Anlage und Konfiguration eines Projekts der Sofort unter https://www.sofort.com/payment/users/login, nachdem Sie sich dort mit Kundennummer und Passwort angemeldet haben.

Anmeldung auf der Webseite von Sofort


Neues Projekt anlegen

Zur Einrichtung Ihres Projektes klicken Sie links unterhalb von Projekte auf Neues Projekt, wählen im Bereich Neues Projekt anlegen die Variante Sofort und klicken daneben auf Projekt anlegen.

Richtiges Projekt auswählen und anlegen


Wählen Sie dann das Classic-Projekt und klicken auf Projekt anlegen. Bei den allgemeinen Einstellungen ist der Projektname für Ihren Shop frei wählbar. Empfehlenswert ist ein aussagekräftiger Projektname, so dass ggf. auch der Käufer diesen wiedererkennt. Im Kombinationsfeld Shop-System stellen Sie nun Computop (Payment Service Provider) ein. Wählen Sie darunter eine Branche  sowie den genaueren Bereich aus und tragen die Webseite ein. Solange die Anbindung getestet werden soll, aktivieren Sie die Option Testmodus.

Danach folgen Angaben zur Adresse, der voreingestellten Währung für Kunden sowie zur Bankverbindung, die das Projekt verwenden soll. Die Eingaben bestätigen Sie weiter unten per Klick auf die Schaltfläche Speichern.

Einrichtung eines neuen Projektes


Schnelleinstellung der Schnittstelle

Die Einstellungen der Schnittstelle definieren die nötigen Links, damit der Kunde nach der Transaktion wieder richtig zu Ihrem Shop zurückgeleitet wird.

Der Erfolgslink definiert die URL, die nach erfolgreicher Zahlung aufgerufen wird. Geben Sie dort folgende URL ein:

https://www.computop-paygate.com/cbsofort.aspx?result=success&user_id=-USER_ID-&project_id=-PROJECT_ID-&transaction=-TRANSACTION-&sender_holder=-SENDER_HOLDER_URLENCODE-&sender_country_id=-SENDER_COUNTRY_ID-&sender_account_number=-SENDER_ACCOUNT_NUMBER-&sender_bank_name=-SENDER_BANK_NAME_URLENCODE-&sender_bank_code=-SENDER_BANK_CODE-&sender_iban=-SENDER_IBAN-&currency_id=-CURRENCY_ID-&reason_1=-REASON_1-&reason_2=-REASON_2_URLENCODE-&user_variable_0=-USER_VARIABLE_0-&user_variable_1=-USER_VARIABLE_1-&security_criteria=-SECURITY_CRITERIA-&date=-DATE-&time=-TIME- 


Danach muss die Option Automatische Weiterleitung aktiviert sein.

Der Abbruchlink wird verwendet, wenn die Zahlung nicht erfolgreich war und abgebrochen wurde. Geben Sie dort folgende URL ein:

https://www.computop-paygate.com/cbsofort.aspx?result=cancel&user_id=-USER_ID-&project_id=-PROJECT_ID-&transaction=-TRANSACTION-&sender_holder=-SENDER_HOLDER_URLENCODE-&sender_country_id=-SENDER_COUNTRY_ID-&sender_account_number=-SENDER_ACCOUNT_NUMBER-&sender_bank_name=-SENDER_BANK_NAME_URLENCODE-&sender_bank_code=-SENDER_BANK_CODE-&sender_iban=-SENDER_IBAN-&currency_id=-CURRENCY_ID-&reason_1=-REASON_1-&reason_2=-REASON_2_URLENCODE-&user_variable_0=-USER_VARIABLE_0-&user_variable_1=-USER_VARIABLE_1-&security_criteria=-SECURITY_CRITERIA-&date=-DATE-&time=-TIME-


URL-Einstellungen für die Schnittstelle


Erweiterte Einstellungen der Shopsystem-Schnittstelle

Die erweiterten Einstellungen der Schnittstelle zum Shopsystem sind erst verfügbar, wenn das Projekt komplett angelegt wurde. Klicken Sie dafür links im Menü unterhalb von Projekte auf Meine Projekte und dann beim betreffenden Projekt rechts auf das Bearbeiten-Symbol (grüner Stift). Im folgenden Dialog wechseln Sie zum Register Erweiterte Einstellungen. Folgen Sie dort dem Link Shopsystem-Schnittstelle.

In den Feldern Erfolgslink sowie Abbruchlink sind dieselben URLs wie bereits bei den Schnelleinstellungen der Schnittstelle vorzunehmen. Das Feld HTML-Info-Text wird nicht verwendet und bleibt daher frei. Außerdem tragen Sie bei Timeout in Sekunden die gewünschte Dauer wie zum Beispiel 2400 ein. Danach folgt der Timeout-Link:

https://www.computop-paygate.com/cbsofort.aspx?result=timeout&user_id=-USER_ID-&project_id=-PROJECT_ID-&transaction=-TRANSACTION-&sender_holder=-SENDER_HOLDER_URLENCODE-&sender_country_id=-SENDER_COUNTRY_ID-&sender_account_number=-SENDER_ACCOUNT_NUMBER-&sender_bank_name=-SENDER_BANK_NAME_URLENCODE-&sender_bank_code=-SENDER_BANK_CODE-&sender_iban=-SENDER_IBAN-&currency_id=-CURRENCY_ID-&reason_1=-REASON_1-&reason_2=-REASON_2_URLENCODE-&user_variable_0=-USER_VARIABLE_0-&user_variable_1=-USER_VARIABLE_1-&security_criteria=-SECURITY_CRITERIA-&date=-DATE-&time=-TIME-

Nicht änderbare Parameter

Für den weiteren Ablauf können Sie bestimmte Parameter fixieren, so dass der Kunde diese im Zahlungsformular nicht mehr ändern kann. Im zuständigen Dialogbereich markieren Sie dafür die Optionen Betrag und Verwendungszweck. Die Bankverbindung muss der Kunde jedoch noch ändern können. Bestätigen Sie die Einstellungen per Klick auf Speichern.

Auswahl fixierter Parameter


Dem Händler ist freigestellt, ein eigenes Firmenlogo auf den Zahlseiten zu platzieren. Dafür folgen Sie bei den erweiterten Einstellungen zuerst dem Link Projektlogo. Wenn bereits ein Projektlogo zugeordnet ist, wird dieses oben angezeigt. Dann klicken Sie im Bereich Firmenlogo neben Wählen Sie eine Grafik auf Durchsuchen und laden die gewünschte eigene Grafikdatei hoch. Wählen Sie die weiteren Optionen und bestätigen die Einrichtung per Klick auf Speichern.

Zuordnung des eigenen Firmenlogos


Benachrichtigungen

Folgen Sie bei den erweiterten Einstellungen zuerst dem Link Benachrichtigungen. Die Übersicht zeigt alle bereits eingerichteten Benachrichtigungen. Zur Neuanlage folgen Sie dem Link Neue Benachrichtigung anlegen. Wechseln Sie dann zum Register HTTP. Zur Bearbeitung bereits vorhandener Einträge klicken Sie stattdessen rechts neben dem betreffenden Eintrag auf das Bearbeiten-Symbol (grüner Stift).

Im Bereich HTTP-Benachrichtigung bearbeiten nehmen Sie die nötigen Einstellungen vor. Folgende Abbildung zeigt ein Beispiel dafür.

Bearbeiten einer Benachrichtigung



Je nach gewählter Methode POST oder GET tragen Sie den entsprechenden Link wie folgt ein.

GET: https://www.computop-paygate.com/sofortcomplete.aspx?security_criteria_text=-SECURITY_CRITERIA_TEXT-

POST: https://www.computop-paygate.com/sofortcomplete.aspx?


Hinweis: Bei der http-Benachrichtigung werden bereits automatisch eine Vielzahl von Parametern angehängt. Daher ist der obige Link kürzer als bei den Weiterleitungen.

Hinweis: Bei der Methode „GET“ werden die tatsächlich genutzten Kontodaten (Käufer kann diese im Formular bei Sofort GmbH ändern) mit „XXX“ maskiert zurückgeliefert. Mit „POST“ kommen diese Parameter im Klartext zurück. Nur in diesem Fall werden die Parameter gespeichert und überschreiben ggf. die vom Kunden an uns gesendeten Werte.

Die zusätzliche Verwendung von anderen Benachrichtigungstypen wie etwa E-Mail ist freigestellt, wird aber nicht empfohlen.


Projekt-Passwort und Eingabeprüfung

Um das Projekt-Passwort zu generieren, wählen Sie links unter Projekte zuerst Meine Projekte aus. Klicken Sie beim betreffenden Projekt rechts auf das Bearbeiten-Symbol (grüner Stift). Im folgenden Dialog wechseln Sie zum Register Erweiterte Einstellungen und folgen dort dem Link Passwörter und Hash-Algorithmus. Per Klick auf die grüne Schaltfläche Projekt-Passwort generieren und Bestätigung des danach angezeigten Dialogfelds wird Ihnen das Projekt-Passwort angezeigt. Sollte bereits ein Projekt-Passwort generiert worden sein, können Sie es sich an gleicher Stelle über den Link Aktuelles Projektpasswort anzeigen erneut anzeigen lassen. In gleicher Weise können Sie auch das Benachrichtigungspasswort ändern oder abfragen.

Projekt bearbeiten


Dieses müssen Sie zusammen mit Ihrer Kundennummer sowie der Projekt-ID an den Support unter Computop Helpdesk senden, damit die Zahlungsart im Paygate eingerichtet werden kann.

Die Input-Prüfung muss aktiviert und als Algorithmus SHA256 gewählt werden. Bestätigen Sie die Einstellungen per Klick auf die Schaltfläche Speichern.

Die Verwendung der übrigen Einstellungen für Bankverbindungen, Sperrlisten oder einem Master-Passwort sind dem Händler freigestellt.

Passwörter verwalten



Konfiguration für Sofort Ident

Beginnen Sie mit der Anlage und Konfiguration eines Projekts für Sofort Ident unter https://www.sofort.com/payment/users/login, nachdem Sie sich dort mit Kundennummer und Passwort angemeldet haben. Je nach Vertrag mit Sofort muss Sofort Ident gegebenenfalls unter Mein Konto – Produkt-Aktivierung zuerst aktiviert werden.

Zur Einrichtung Ihres Projektes klicken Sie links unterhalb von Projekte auf Neues Projekt, wählen im Bereich Neues Projekt anlegen die Variante  Sofort Ident und klicken daneben auf Projekt anlegen.

Sofort Ident Projekt auswählen und anlegen


Bei den allgemeinen Einstellungen ist der Projektname für Ihren Shop frei wählbar. Solange die Anbindung getestet werden soll, aktivieren Sie die Option Testmodus.

Danach folgen Angaben zur Adresse sowie spezielle Einstellungen für Sofort Ident. Wichtig ist hier die Rücksprung-URL, mit der der Kunde nach der Verifizierung über Sofort Ident wieder in den Shop zurückgeleitet wird. Geben Sie dort folgende URL ein:

https://www.computop-paygate.com/cbsofort.aspx?user_id=-USER_ID-&project_id=-PROJECT_ID-&transaction=-TRANSACTION-&user_variable_0=-USER_VARIABLE_0_URLENCODE-&user_variable_1=-USER_VARIABLE_1_URLENCODE-


Danach muss die Option Automatische Weiterleitung aktiviert sein.

Außerdem werden Ihnen hier die automatisch generierten Werte für das Projekt-Passwort sowie das Benachrichtigungspasswort angezeigt. Letzteres wird für die Berechnung des Hashwertes bei Benachrichtigungen benötigt.

Die Eingaben bestätigen Sie weiter unten per Klick auf die Schaltfläche Speichern.

Spezielle Einstellungen für Sofort Ident


Nicht änderbare Parameter

Für den weiteren Ablauf können Sie bestimmte Parameter fixieren, die der Kunde im Formular nicht mehr ändern kann. Im zuständigen Dialogbereich markieren Sie dafür beispielsweise die Optionen Vorname und Nachname. Bestätigen Sie die Einstellungen per Klick auf Speichern.

Auswahl fixierter Parameter für Ident


Projektlogo

Dem Händler ist freigestellt, ein eigenes Firmenlogo auf den Seiten zu platzieren. Dafür folgen Sie bei den erweiterten Einstellungen zuerst dem Link Projektlogo. Dann klicken Sie unterhalb von Firmenlogo neben Wählen Sie eine Grafik auf Durchsuchen und laden die gewünschte eigene Grafikdatei hoch. Bestätigen Sie die Einrichtung per Klick auf Speichern.

Zuordnung des eigenen Firmenlogos


Benachrichtigungen

Folgen Sie bei den erweiterten Einstellungen zuerst dem Link Benachrichtigungen. Die Übersicht zeigt alle bereits eingerichteten Benachrichtigungen. Zur Neuanlage folgen Sie dem Link Neue Benachrichtigung anlegen. Wechseln Sie dann zum Register HTTP. Zur Bearbeitung bereits vorhandener Einträge klicken Sie stattdessen rechts neben dem betreffenden Eintrag auf das Bearbeiten-Symbol (grüner Stift).

Im Bereich HTTP-Benachrichtigung bearbeiten nehmen Sie die nötigen Einstellungen vor. Folgende Abbildung zeigt ein Beispiel dafür.

Bearbeiten einer Benachrichtigung

Je nach gewählter Methode POST oder GET tragen Sie den entsprechenden Link wie folgt ein.

GET: https://www.computop-paygate.com/sofortcomplete.aspx?user_id=-USER_ID-&project_id=-PROJECT_ID-&transaction=-TRANSACTION-&user_variable_0=-USER_VARIABLE_0-&user_variable_1=-USER_VARIABLE_1-&firstname=-FIRSTNAME_URLENCODE-&lastname=-LASTNAME_URLENCODE-&birthday=-BIRTHDAY-&city=-CITY-&street=-STREET_URLENCODE-&zipcode=-ZIPCODE_URLENCODE-

POST: https://www.computop-paygate.com/sofortcomplete.aspx?


Hinweis: Bei der http-Benachrichtigung werden bereits automatisch eine Vielzahl von Parametern angehängt. Daher ist der obige Link kürzer als bei den Weiterleitungen.

Hinweis: Bei der Methode „GET“ werden die tatsächlich genutzten Kontodaten (Käufer kann diese im Formular bei Sofort GmbH ändern) mit „XXX“ maskiert zurückgeliefert. Mit „POST“ kommen diese Parameter im Klartext zurück. Nur in diesem Fall werden die Parameter gespeichert und überschreiben ggf. die vom Kunden an uns gesendeten Werte.

Die zusätzliche Verwendung von anderen Benachrichtigungstypen wie etwa E-Mail ist freigestellt, wird aber nicht empfohlen.


Projekt-Passwort und Eingabeprüfung

Bei Sofort Ident werden Passwörter stets bei der Anlage eines Projektes generiert. Um das Projekt-Passwort und das Benachrichtigungspasswort anzuzeigen, wählen Sie links unter Projekte zuerst Meine Projekte aus. Klicken Sie beim betreffenden Projekt rechts auf das Bearbeiten-Symbol (grüner Stift). Im folgenden Dialog wechseln Sie zum Register Erweiterte Einstellungen und folgen dort dem Link Passwörter und Hash-Algorithmus. Per Klick auf die grüne Schaltfläche Projekt-Passwort generieren und Bestätigung des danach angezeigten Dialogfelds können Sie ein neues Projekt-Passwort erzeugen. Ein bereits vorhandenes Projekt-Passwort können Sie sich an gleicher Stelle über den Link Aktuelles Projektpasswort anzeigen erneut anzeigen lassen. In gleicher Weise können Sie auch das Benachrichtigungspasswort ändern oder abfragen.

Beide Passwörter müssen Sie zusammen mit Ihrer Kundennummer sowie der Projekt-ID an den Support unter Computop Helpdesk senden, damit die Zahlungsart im Paygate eingerichtet werden kann.

Die Input-Prüfung muss aktiviert und als Algorithmus SHA256 gewählt werden. Bestätigen Sie die Einstellungen per Klick auf die Schaltfläche Speichern.

Passwörter verwalten



Konfiguration für iDEAL

Auch iDEAL lässt sich per Sofort nutzen. Voraussetzung dafür ist, dass Sie das Produkt zuerst in Ihrem Konto von Sofort aktivieren und dann separat ein Projekt dafür anlegen. Außerdem ist für die Nutzung von iDEAL über Sofort ein Businesskonto bei der Deutschen Handelsbank erforderlich.

Klicken Sie dazu links im Menü unterhalb von Mein Konto auf Produkt-Aktivierung. Wählen Sie daneben das Produkt iDEAL aus und klicken dann auf die Schaltfläche Verbindlich aktivieren.



Produktaktivierung von iDEAL


Projekt anlegen

Im nächsten Schritt legen Sie ein separates neues Projekt für iDEAL an. Dazu klicken Sie links im Menü unterhalb von Projekte auf Neues Projekt, wählen im Bereich Neues Projekt anlegen die Variante  iDEAL und klicken daneben auf Projekt anlegen.

Für ein iDEAL-Projekt müssen Sie ein Konto bei der Deutschen Handelsbank haben. Falls bereits ein Konto existiert, wählen Sie die Option Ich habe ein Sofort Bank Konto und klicken auf Weiter. Anderenfalls wählen Sie die Option Ich habe noch kein Sofort Bank Konto und klicken ebenfalls auf Weiter. Folgen Sie dann den Schritten für die Kontoeinrichtung.

Projekt für iDEAL anlegen


Im Bereich Allgemeine Einstellungen ist der Projektname für Ihren Shop frei wählbar. Im Kombinationsfeld Shop-System stellen Sie nun Eigenes Shop-System (selbst programmiert) ein. Solange die Anbindung getestet werden soll, aktivieren Sie die Option Testmodus. Weitere Angaben für Adresse und Bankverbindung werden automatisch übernommen.

Grundeinstellungen für das iDEAL-Projekt


Einstellungen der Schnittstelle

Die Einstellungen der Schnittstelle definieren die nötigen Links, damit der Kunde nach der Transaktion wieder richtig zu Ihrem Shop zurückgeleitet wird.

Der Erfolgslink definiert die URL, die nach erfolgreicher Zahlung aufgerufen wird. Geben Sie dort folgende URL ein:

https://www.computop-paygate.com/cbsofort.aspx?result=success&user_id=-USER_ID-&project_id=-PROJECT_ID-&transaction=-TRANSACTION-&sender_holder=-SENDER_HOLDER_URLENCODE-&sender_country_id=-SENDER_COUNTRY_ID-&sender_account_number=-SENDER_ACCOUNT_NUMBER-&sender_bank_name=-SENDER_BANK_NAME_URLENCODE-&sender_bank_code=-SENDER_BANK_CODE-&sender_iban=-SENDER_IBAN-&currency_id=-CURRENCY_ID-&reason_1=-REASON_1-&reason_2=-REASON_2_URLENCODE-&user_variable_0=-USER_VARIABLE_0-&user_variable_1=-USER_VARIABLE_1-&security_criteria=-SECURITY_CRITERIA-&date=-DATE-&time=-TIME-&status=-status-&user_variable_5=-USER_VARIABLE_5-


Danach muss die Option Automatische Weiterleitung aktiviert sein.

Der Abbruchlink wird verwendet, wenn die Zahlung nicht erfolgreich war und abgebrochen wurde. Geben Sie dort folgende URL ein:

https://www.computop-paygate.com/cbsofort.aspx?result=cancel&user_id=-USER_ID-&project_id=-PROJECT_ID-&transaction=-TRANSACTION-&sender_holder=-SENDER_HOLDER_URLENCODE-&sender_country_id=-SENDER_COUNTRY_ID-&sender_account_number=-SENDER_ACCOUNT_NUMBER-&sender_bank_name=-SENDER_BANK_NAME_URLENCODE-&sender_bank_code=-SENDER_BANK_CODE-&sender_iban=-SENDER_IBAN-&currency_id=-CURRENCY_ID-&reason_1=-REASON_1-&reason_2=-REASON_2_URLENCODE-&user_variable_0=-USER_VARIABLE_0-&user_variable_1=-USER_VARIABLE_1-&security_criteria=-SECURITY_CRITERIA-&date=-DATE-&time=-TIME-&status=-status-&user_variable_5=-USER_VARIABLE_5-


Abschließend klicken Sie auf die Schaltfläche Speichern, um das iDEAL-Projekt fertig anzulegen.

URL-Einstellungen für die Schnittstelle


Benachrichtigungen

Öffnen Sie die Bearbeitung des betreffenden Projektes, wechseln dann zum Register Erweiterte Einstellungen und klicken dort auf den Link Benachrichtigungen. Dann folgen Sie dem Link Neue Benachrichtigung anlegen.

Wechseln Sie auf dieser Seite zum Register HTTP mit Zahlungsstatus. Nun wählen Sie nacheinander die Optionen Aktiviert sowie in der Gruppe Aktiv für die einzelnen Einträge Zahlung ausstehend, Zahlung erhalten, Zahlung nicht erhalten und Transaktion storniert. Darunter tragen Sie als Benachrichtigungs-URL https://www.computop-paygate.com/sofortcomplete.aspx? ein. Wählen Sie nun noch per Option die Methode POST aus und schließen die Konfiguration mit einem Klick auf die Schaltfläche Speichern ab.

Benachrichtigung anlegen


Passwörter und Hash-Algorithmus

Öffnen Sie die Bearbeitung des betreffenden Projektes, wechseln dann zum Register Erweiterte Einstellungen und klicken dort auf den Link Passwörter und Hash-Algorithmus. Über den Link Aktuelles Projektpasswort anzeigen fragen Sie das gesetzte Passwort ab. Dieses müssen Sie zusammen mit Ihrer Kundennummer sowie der Projekt-ID an den Support unter Computop Helpdesk senden, damit die Zahlungsart im Paygate eingerichtet werden kann.

Im Bereich Input-Prüfung stellen Sie außerdem im Kombinationsfeld Hash-Algorithmus den Wert SHA256 ein. Bestätigen Sie das per Klick auf Speichern.

Eingabeprüfung konfigurieren


Projektübersicht

Eine Übersicht aller Daten finden Sie im Hauptmenü links im Bereich Projekte unter Meine Projekte. Hier können Sie für alle Projekte Ihre Kundennummer sowie die einzelnen Projekt-IDs abfragen, falls Sie diese Daten später noch für die Einrichtung der Zahlungsarten im Paygate benötigen.

Übersicht Ihrer angelegten Projekte


Paygate-Schnittstelle

Definitionen

Datenformate:

FormatBeschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

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


Abkürzungen:

AbkürzungBeschreibungKommentar

CND

Bedingung (condition)


M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

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

C

bedingt (conditional)

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


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


Aufruf der Schnittstelle

Um eine Online-Überweisung mit Sofort abzuwickeln, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/sofort.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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyRESTFormatCNDDescriptionBeschreibung

MerchantID

BasicAuth.Username

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyRESTFormatCNDDescriptionBeschreibung
TransID"transactionId": "..."

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyRESTFormatCNDDescriptionBeschreibung
refnr"referenceNumber": "..."

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyRESTFormatCNDDescriptionBeschreibung
Amount"amount": { "value": ...}

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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.

KeyRESTFormatCNDDescriptionBeschreibung
Currency"amount": { "currency": "..."}

a3

M

Currency, three digits DIN / ISO 4217. Only EUR, GBP, PLN, CZK and CHF permissible. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217. Nur EUR, GBP, PLN, CZK und CHF zulässig. Hier eine Übersicht: A1 Währungstabelle

Key

REST

Format

CND

Description

Beschreibung

OrderDesc

"order": {"description[0]": "..."}

ans..384

M

Reason for payment on customer-account statement.

Notice: Only the first 27 characters appear on the customer-account statement. You can view the full data in Computop Analytics.

Verwendungstext auf dem Kontoauszug des Kunden.

Hinweis: Nur die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. In Computop Analytics können Sie die Daten komplett einsehen.

OrderDesc2"order": {"description[1]": "..."}ans..384O

Second row of reason for payment on customer-account statement.

Notice: Only the first 27 characters appear on the customer-account statement. You can view the full data in Computop Analytics.

Zweite Verwendungstextzeile auf dem Kontoauszug des Kunden.

Hinweis: Nur die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. In Computop Analytics können Sie die Daten komplett einsehen.

Sofortaction

"payment": {"sofort": {"sofortAction"="Ident"}}

"payment": {"sofort": {"sofortAction"="Ideal"}}

ans..10O„Ident“ for Sofort Ident or „Ideal“ for Sofort iDEAL„Ident“ für Sofort Ident oder „Ideal“ für Sofort iDEAL
IssuerID"payment": {"sofort": {"issuerId": "..."}}ans..30O

ID of the bank through which iDEAL transfers are to be made; obligatory in case of Sofortaction=ideal

Following IssuerIDs are available:

RABONL2U    Rabobank
INGBNL2A     ING
ABNANL2A     ABN Amro
ASNBNL21     ASN Bank
SNSBNL2A     SNS Bank
RBRBNL21     Regiobank
TRIONL2U     Triodos Bank
FVLBNL22     Van Lanschot Bankiers
KNABNL2H     Knab
BUNQNL2A    bunq
MOYONL21     Moneyou

ID der Bank, über die iDEAL-Überweisungen erfolgen sollen; Pflicht bei Sofortaction=ideal

Folgende IssuerIDs sind verfügbar:

RABONL2U Rabobank
INGBNL2A ING
ABNANL2A ABN Amro
ASNBNL21 ASN Bank
SNSBNL2A SNS Bank
RBRBNL21 Regiobank
TRIONL2U Triodos Bank
FVLBNL22 Van Lanschot Bankiers
KNABNL2H Knab
BUNQNL2A bunq
MOYONL21 Moneyou

Timeout"expirationTime": ...n4OValidity of transaction in seconds with Sofort GmbH. We recommend a maximal value of 2400 seconds.Gültigkeit der Transaktion in Sekunden bei Sofort GmbH. Wir empfehlen einen Maximalwert von 2400 Sekunden.
AccNr"payment": {"sofort": {"account": {"accountNumber": "..."}}}n..12OAccount numver of the user which appears predefined in the transfer windowKontonummer des Nutzers, die voreingestellt im Überweisungsfenster erscheint
AccOwner"payment": {"sofort": {"account": {"accountHolder": "..."}}}as..50OName of account holderName des Kontoinhabers
IBAN"payment": {"sofort": {"account": {"number": "..."}}}an..34OIBAN of the user which appears predefined in the transfer windowIBAN des Nutzers, die voreingestellt im Überweisungsfenster erscheint
BIC"payment": {"sofort": {"account": {"code": "..."}}}an..11OBIC of the user which appears predefined in the transfer windowBIC des Nutzers, die voreingestellt im Überweisungsfenster erscheint
AccIBAN"payment": {"sofort": {"account": {"sortCode": "..."}}}ans..8O

Bank sort code of the user which appears predefined in the transfer window. 8-digit in DE, 5-digit in AT, 3-digit in BE, 5-digit in FR, 6-digit in GB and 6-digit in NL

The following values apply in NL: NL_102 (Fortis Bank); NL_103 (ABN Amro Bank), NL_104 (Sns Bank), NL_106 (ING Bank), NL_109 (Sns Regio Bank)

Bankleitzahl des Nutzers, die voreingestellt im Überweisungsfenster erscheint. In DE 8-stellig, in AT 5-stellig, in BE 3-stellig, in FR 5-stellig, in GB 6-stellig und in NL 6-stellig.

In NL gelten folgende Werte: NL_102 (Fortis Bank); NL_103 (ABN Amro Bank), NL_104 (Sns Bank), NL_106 (ING Bank), NL_109 (Sns Regio Bank)

AccBank"payment": {"sofort": {"account": {"name": "..."}}}ans..50OName of the bank of the user which appears predefined in the transfer windowBezeichnung der Bank des Nutzers, die voreingestellt im Überweisungsfenster erscheint
Email"billing": {"contactInfo": {"email": "..."}}ans..255OEmail address of the customerE-Mail-Adresse des Kunden
AddrCountryCode"billing": {"addressInfo": {"country": {"A2": "..."}}}a2MTwo characters country code according to ISO 3166. Presently DE, AT, BE, NL, ES, CH, PL, IT permitted.Ländercode zweistellig gemäß ISO 3166. Derzeit DE, AT, BE, NL, ES, CH, PL, IT zulässig.
Language"language": "..."a2OLanguage: de - German, en – English, fr- French, nl - Dutch, pl - PolishSprache: de - deutsch, en – Englisch, fr- Französisch, nl - Niederländisch, pl - Polnisch

KeyRESTFormatCNDDescriptionBeschreibung

MAC

---

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyRESTFormatCNDDescriptionBeschreibung
URLSuccess"urls": {"success": "..."}

ans..256

M

Complete URL which calls up Paygate if payment has been successful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

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.

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten
  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

KeyRESTFormatCNDDescriptionBeschreibung
URLFailure"urls": {"failure": "..."}

ans..256

M

Complete URL which calls up Paygate if payment has been unsuccessful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

Vollständige URL, die das Paygateaufruft, 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.

(info) Allgemeine Hinweise:

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

KeyRESTFormatCNDDescriptionBeschreibung
Response

---

a7

O

Status response sent by Paygate to URLSuccess and URLFailure, should be encrypted. For this purpose, transmit Response=encrypt parameter.

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

KeyRESTFormatCNDDescriptionBeschreibung
URLNotify"urls": {"notify": "..."}

ans..256

M

Complete URL which Paygate calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters: Use the UserData parameter instead.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

(info) Allgemeine Hinweise:

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

KeyRESTFormatCNDDescriptionBeschreibung
UserData"metadata[userData]": "..."

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

KeyRESTFormatCNDDescriptionBeschreibung
ReqId"requestId": "..."

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

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

REST

Format

CND

Description

Beschreibung

UserID

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

n..5

O

Customer number

Kundennummer

ProjectID

"payment": {"sofort": {"projectId": ...}}

n..5

O

Project number

Projektnummer

FirstName

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

as..30

OC

Only with Sofort Ident: First name

nur bei Sofort Ident: Vorname

LastName

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

as..30

OC

Only with Sofort Ident: Last name

nur bei Sofort Ident: Nachname

AddrStreet

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

ans..30

OC

Only with Sofort Ident: Street

nur bei Sofort Ident: Straße

AddrCity

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

ans..30

OC

Only with Sofort Ident: City

nur bei Sofort Ident: Wohnort

AddrZip

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

n..5

OC

Only with Sofort Ident: Postcode

nur bei Sofort Ident: Postleitzahl

Birthday

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

dttm8

OC

Only with Sofort Ident: Date of birth in the format YYYYMMDD

nur bei Sofort Ident: Geburtsdatum im Format JJJJMMTT

Parameter für Sofort


Bei Verwendung der REST-API

Bei Verwendung der REST-API erhalten Sie immer einen Link, über den der Händler den Verbraucher umleiten muss, um die Zahlung abzuschließen.

RESTFormatCNDBeschreibung

"paymentId": "..."

an32M

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

"_Links.self.type": "..."an..20M

"application/json"

"_Links.redirect.href": "..."an..1024MDer Händler muss den Kunden zu dieser URL weiterleiten, um die Zahlung abzuschließen
"_Links.redirect.type": "..."an..20M"text/html"

Der Händler kann inquire.aspx verwenden

Bei Verwendung der Key-Value-Pair-API

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:

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

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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

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

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK or AUTHORIZED (URLSuccess) as well as FAILED (URLFailure)

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

Key

Format

CND

Description

Beschreibung

TransactionID

ans..27

M

Unique transaction ID assigned by Sofort GmbH

Eindeutig von Sofort GmbH vergebene TransaktionsID

SecCriteria

n1

M

Receipt of money according to Sofort <1> guaranteed, <0> not guaranteed. If the value is 0 please wait for receipt before dispatching the goods.

Geldeingang laut Sofort <1> gewährleistet, <0> nicht gewährleistet. Bitte warten Sie bei 0 auf den Geldeingang, bevor Sie die Ware verschicken.

AccOwner

as..50

M

Name of account holder

Name des Kontoinhabers

AccNr

n..12

M

Account holder’s account number

Kontonummer des Kontoinhabers

AccIBAN

an..8

M

Bank sort code of the account holder

Bankleitzahl des Kontoinhabers

AccBank

ans..50

M

Name of the account holder’s bank

Bezeichnung der Bank des Kontoinhabers

IBAN

an..34

M

International Bank Account Number

International Bank Account Number

BIC

an..11

M

Bank Identifier Code:

Bank Identifier Code

Email

ans..255

O

Email address of the customer

E-Mail-Adresse des Kunden

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

Key

Format

CND

Description

Beschreibung

FirstName

as..30

C

Only with Sofort Ident: First name

nur bei Sofort Ident: Vorname

LastName

as..30

C

Only with Sofort Ident: Last name

nur bei Sofort Ident: Nachname

AddrStreet

ans..30

C

Only with Sofort Ident: Street

nur bei Sofort Ident: Straße

AddrCity

ans..30

C

Only with Sofort Ident: City

nur bei Sofort Ident: Wohnort

AddrZip

n..5

C

Only with Sofort Ident: Postcode

nur bei Sofort Ident: Postleitzahl

Birthday

dttm8

C

Only with Sofort Ident: Date of birth

nur bei Sofort Ident: Geburtsdatum

Age

n..3

C

Only in case of success with Sofort Ident: Age

nur im Erfolgsfall bei Sofort Ident: Alter

Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure bei Sofort



Gutschrift zu Sofort

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Das Paygate erlaubt einerseits Gutschriften, die sich auf eine vorher über das Paygate getätigte Buchung beziehen, andererseits können Sie Gutschriften ohne Bezugstransaktion ausführen. Um eine Gutschrift über Computop durchzuführen, muss zusätzlich die Zahlart Klarna Payments angebunden sein.

Den nötigen API-Key für die Kommunikation finden Sie im Menü Ihres Sofort-Kontos im Bereich Weitere Dienste unter API-Key:

Um eine Gutschrift 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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyRESTFormatCNDDescriptionBeschreibung

MerchantID

BasicAuth.Username

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyRESTFormatCNDDescriptionBeschreibung
PayID"paymentId": "..."

an32

M

ID assigned by Paygate for the payment to be credited

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

KeyRESTFormatCNDDescriptionBeschreibung
TransID"transactionId": "..."

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyRESTFormatCNDDescriptionBeschreibung

MAC

---

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyRESTFormatCNDDescriptionBeschreibung
Amount"amount": { "value": ...}

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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.

KeyRESTFormatCNDDescriptionBeschreibung
Currency"amount": { "currency": "..."}

a3

M

Currency, three digits DIN / ISO 4217. Only EUR, GBP, PLN, CZK and CHF permissible. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217. Nur EUR, GBP, PLN, CZK und CHF zulässig. Hier eine Übersicht: A1 Währungstabelle

Key

REST

Format

CND

Description

Beschreibung

OrderDesc

"order": {"description": "..."}

ans..768

OC

Description of refunded goods, unit prices, merchant’s comment etc.Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.
CredNo"payment": {"sofort": {"creditNumber": "..."}}ansOCCredit number. Will be set to “0” if not transmitted.Kreditnummer. Wird auf den Wert „0“ gesetzt, falls nicht übermittelt.

KeyRESTFormatCNDDescriptionBeschreibung
ReqId"requestId": "..."

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

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.

Parameter für Gutschriften über Socket-Verbindungen


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

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

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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyRESTFormatCNDDescriptionBeschreibung

mid

"merchantId": "..."

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyRESTFormatCNDDescriptionBeschreibung
PayID"paymentId": "..."

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

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

KeyRESTFormatCNDDescriptionBeschreibung
XID"xId": "..."

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

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

KeyRESTFormatCNDDescriptionBeschreibung
TransID"transactionId": "..."

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyRESTFormatCNDDescriptionBeschreibung
Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyRESTFormatCNDDescriptionBeschreibung
Description"description": "..."

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyRESTFormatCNDDescriptionBeschreibung
Code"code": ...

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

Antwort-Parameter bei Gutschriften für Sofort über Socket-Verbindungen