1 Über die Lastschrift

1.1 Allgemeines zu Lastschrift

Logo

InfoTyp
Das 1cs Online Bezahlsystem ermöglicht Ihnen die Abwicklung der beim Kunden beliebten Zahlart Lastschrift und ist dabei vollständig SEPA-kompatibel. Optional mit Sperrlistenprüfung und Zahlungsgarantie.Zahlungen per Lastschrift

Das 1cs Online Bezahlsystem kann elektronische Lastschriften (ELV) in Deutschland mit einer Sperrlistenprüfung kombinieren, die Ihnen bei geringen Kosten eine hohe Sicherheit bietet: Zum einen prüft das 1cs Online Bezahlsystem, ob die Kontonummer des Kunden in großen Handelsunternehmen gesperrt ist. Zum anderen können Sie Betrug vorbeugen, indem Sie Umsatzlimits pro Tag, Woche oder Monat festlegen, die eine Kontoverbindung nicht überschreiten darf.

Da es erheblich mehr Konten als Kreditkarten gibt, wird eine Vielzahl der Internet-Einkäufe per Lastschrift bezahlt. Das Lastschriftverfahren ist aber für Händler ohne Sperrlistenprüfung unsicher: Bei ELV findet keine Autorisierung statt, weil eine Bonitätsprüfung auf dem Konto des Kunden nicht möglich ist. Deshalb kommt es bei ELV häufig zu Rücklastschriften aufgrund ungedeckter Konten.

Die Sperrlistenprüfung verbindet die Vorteile der Lastschrift mit einer höheren Sicherheit durch die Sperrlistenprüfung und individuelle Umsatzlimits.

1.1.1 Ablauf einer Lastschrift-Zahlung im Internet

Um mit Hilfe einer Lastschrift zu bezahlen, wählt der Kunde an der Internet-Kasse die Zahlungsmethode Lastschrift aus und gibt auf einer Internet-Seite seine Kontoverbindung ein. Diese Internet-Seite ist mit SSL verschlüsselt, um die Kontodaten während der Übertragung vor Abhören und Manipulation zu schützen. Nach der Eingabe prüft das 1cs Online Bezahlsystem, ob die Kontoverbindung gesperrt ist und ob das Umsatzlimit für dieses Konto erreicht ist. Nach erfolgreicher Prüfung zieht das 1cs Online Bezahlsystem die Lastschrift bei der Bank des Kunden für Sie ein.

1.1.2 SEPA-Lastschrift

Seit 1. Februar 2014 sind mit SEPA einheitliche Regelungen für den bargeldlosen Zahlungsverkehr in Kraft getreten. Hierfür werden IBAN (International Bank Account Number) und BIC (Bank Identifier Code) als Kontodaten genutzt. Mit dem 1cs Online Bezahlsystem lassen sich Lastschriften SEPA-konform abwickeln.

1.1.3 Zeiträume für Rückbuchungen

Je nach SEPA Mandat hat der Endkunde unterschiedliche Zeiträume, in denen Rückbuchungen ausgelöst werden können.
Autorisierte SEPA Mandate (am POS über PIN/Unterschrift): Der maximale Zeitraum, in welchem der Endkunde eine Rückbuchung auslösen kann, beträgt in diesem Fall 8 Wochen ab Zahlungsdatum.
Unautorisierte SEPA Mandate (bei E-Commerce-Zahlung): Der maximale Zeitraum, in welchem der Endkunde eine Rückbuchung auslösen kann, beträgt in diesem Fall 13 Monate ab Zahlungsdatum.

2 1cs Online Bezahlsystem-Schnittstelle: Formular

2.1 Diagramm zum Prozessablauf per Formular

Prozessablauf einer Lastschriftzahlung über die Formular-Schnittstelle

2.2 Online Bezahlsystem Schnittstelle: Definitionen

2.2.1 Datenformate

FormatBeschreibung
aalphabetisch
asalphabetisch mit Sonderzeichen
nnumerisch
analphanumerisch
ansalphanumerisch mit Sonderzeichen
nsnumerisch mit Sonderzeichen
boolBool’scher Ausdruck (true oder false)
3feste Länge mit 3 Stellen/Zeichen
..3variable Länge mit maximal 3 Stellen/Zeichen
enumAufzählung erlaubter Werte
dttmISODateTime (JJJJ-MM-TTThh:mm:ss)

2.2.2 Abkürzungen

AbkürzungBeschreibungKommentar
CNDBedingung (condition) 
MPflicht (mandatory)Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein
OoptionalWenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich
Cbedingt (conditional)Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

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

2.3 Corporate PayPage

Die 1cs Online Bezahlsystem-Formulare sind standardmäßig weiß und grau eingerahmt. Sie haben jedoch die Möglichkeit, das Layout der Formulare mit Hilfe von Layout-Parametern selbst zu gestalten. Die einfachste Form, das Layout zu beeinflussen, sind Parameter für Hintergrundfarbe (BGColor), Hintergrundbild (BGImage) und die Schrift (FFace). Weitergehende Layout-Anpassungen sind mit XSLT-Templates möglich:

Im Fall von Lastschriftzahlungen können Sie mit dem Parameter Template ein individuelles Layout für das PaySDD-Formular nutzen, das 100%ig zu Ihrem Shop-Layout passt. Zu diesem Zweck entwirft Ihr Grafiker ein HTML-Template im Shop-Design auf Basis der XSLT-Technologie (Extensible Stylesheet Language Transformation). Der First Cash Solution Support kopiert dieses XSLT-Template auf unseren 1cs Online Bezahlsystem-Server. Wenn Sie den Namen Ihrer XSLT-Datei im Parameter Template übergeben, erscheint das 1cs Online Bezahlsystem-Formular in Ihrem Layout.

Allgemeine Informationen zu XSLT finden Sie unter www.w3.org.

Für die Nutzung der Corporate Pay Page mit XSLT gelten die nachfolgenden Konventionen:

2.3.1 Dateinamen

Eine von Ihnen gestaltete XSL-Datei definiert Ihr individuelles Layout. Die zugehörige XML-Datei enthält die Texte, die auf dem Formular angezeigt werden sollen. So lässt sich problemlos eine Mehrsprachigkeit realisieren. In den Bezeichnungen der Dateien verwenden Sie stets Ihre MerchantID.

XSL-Template:                    MerchantID_PaySDD.xsl
XML-Textdatei:                   MerchantID_PaySDD.xml
Unterordner für Bilder:    Templates/imagesMerchantID

Um keine Sicherheitshinweise zu erhalten, stellen Sie bitte bei externen Bildquellen sicher, dass diese über SSL aufgerufen werden.

Zum Aufruf des individuellen Layouts verwenden Sie den Parameter „template“ mit Ihrer MerchantID und hängen ihn unverschlüsselt an den Aufruf der First Cash Solution Bezahlseite an, zum Beispiel: https://www.computop-paygate.com/paysdd.aspx?MerchantID=IhreMID&Len=123&Data=ABCFED…ACEF&template=IhreMerchantID

2.3.2 Feldnamen des Formulars

Bei der Implementierung des Textfeldes für die IBAN verwenden Sie für die Parameter „name“ und „id“ folgende Werte:

Kontoinhaber:                       „AccOwner“
IBAN:                                      „IBAN“
BIC:                                         „BIC“
Kreditinstitut (optional):      „AccBank“

Ein Textfeld zur Eingabe der IBAN wird dann folgendermaßen implementiert:

<input type="text" name="IBAN" id= "IBAN" value=""></input>

2.3.3 Hidden Fields

Folgende Hidden Fields müssen implementiert werden, damit die Werte beim Abschicken des Formulars weitergereicht werden können:

MerchantID:                „MerchantID“
Request-Länge:          „Len“
Request-Daten:           „Data“
Template:                   „Template“
Sprache:                     „Language“

2.3.4 Sprachauswahl

Die Sprachauswahl im PaySDD.aspx-Formular erfolgt automatisch anhand des Parameters Language. Die anderen Sprachbereiche werden herausgefiltert. Wenn Sie z.B. mit JavaScript auf das Feld eines anderen Sprachbereichs zugreifen wollen, ist das über den folgenden Pfad möglich: template/language/@name.

2.3.5 XML-Struktur

Mit dem Parameter „language“ wird gesteuert, welcher Abschnitt der XML-Textdatei ausgelesen wird. Standardmäßig wird immer deutsch „de“ verwendet.

Die XML-Datei sollte folgendes Grundgerüst haben:

<?xml version="1.0" encoding="UTF-16"?>

       </languages>

             <language name="de">              </language>              <language name="en">              </language>        </languages>

Mit <xsl:variable name=““ select=“template/language/@name“/> können Sie direkt von der XSL-Datei einen XML- Sprachenabschnitt ansprechen.

Zum Überblick, welche Parameter zusätzlich von der PaySDD gerendert werden, sehen Sie sich bitte folgende Struktur an (XSL-Datei wird gegen folgenden XML-String gerendert):

Dim strXML As String = "<?xml version='1.0' encoding='UTF-16'?>" & _

       "<template pay='elv'>" & _

                    "<merchantID>"..."</merchantID>" & _                     "<PayID>"..."</PayID>" & _                     "<len>"..."</len>" & _                     "<data>"..."</data>" & _                     "<language>"..."</language>" & _                     "<Border>"..."</Border>" & _                     "<Background>"..."</Background>" & _                     "<BGImage>"..."</BGImage>" & _                     "<BGColor>"..."</BGColor>" & _                     "<FFace>"..."</FFace>" & _                     "<FSize>"..."</FSize>" & _                     "<FColor>"..."</FColor>" & _                     "<twidth>"..."</twidth>" & _                     "<theight>"..."</theight>" & _                     strCustomFieldsXML & _                     "<URLBack>"..."</URLBack>" & _                     "<AccOwner>"..."</AccOwner>" & _                     "<IBAN>"..."</IBAN>" & _                     "<PBAN>"..."</PBAN>" & _                     "<BIC>"..."</BIC>" & _                     "<Bank>"..."</Bank>" & _                     "<template>"..."</template>" & _        "</template>"

Da Sie ein eigenes Layout für Ihr Formular verwenden, benötigen Sie die Layout Parameter nicht. Es ist jedoch möglich, nach voriger Absprache mit der First Cash Solution die Parameter für die Übergabe, z. B. der SessionID zu verwenden.

2.3.6 JavaScript

JavaScript-Funktionen sind, wenn gewünscht, von Ihnen in Ihr Template zu implementieren.

      <script id="clientEventHandlersJS" language="JavaScript">

      if (document.SDDForm.IBAN.value.length > 34)

      {       alert(„<xsl:value-of select=“/template/language/strJavaScript1“/>“);              document.SDDForm.IBAN.focus();       }       ...       </script>

Bitte verwenden Sie keinen externen Link auf Ihr JavaScript.

2.3.7 Link mit Computop-Logo

Wir sind verpflichtet, dem Kontoinhaber jederzeit die Möglichkeit zu geben, sich zu informieren, auf welchem Server er sich befindet. Dazu implementieren Sie bitte ein Computop-Logo wie auf dem Standardformular umgesetzt oder zeigen einen kleinen Impressum-Link an. Das Computop-Logo können Sie auf www.computop.de/downloads abrufen.

Beide Informationen müssen auf die Computop-Seite impressum.aspx verweisen. Diese erwartet den Parameter „Data“, der wie im folgenden Beispiel an die URL angehängt wird.

impressum.aspx?data=<xsl:value-of select="/template/language/@name"/>|<xsl:value-of select="template/merchantID"/>

2.3.8 Programmierung und Test des Formulars

Zunächst gestalten Sie sich eine HTML-Seite mit dem Layout für ihre Bezahlseite und speichern diese zunächst zum Testen mit der Dateiendung htm oder html ab. Öffnen Sie diese Datei im Browser. Als nächste speichern Sie diese als xsl-Datei ab.

<?xml version='1.0' encoding="UTF-16"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:output method="html" encoding="UTF-8"/> <xsl:template match="/"> <html>        <head>              <title>PaySDD Template</title>              <script>Ihr JavaScript</script>        </head>        <body>        <form action="https://www.computop-paygate.de/payinterim.aspx" methode="POST">
       Ihr Formular mit hiddenfields und xsl-tags        </form>        </body> </html> </xsl:template>

Um die Texte aus der XML-Datei zu lesen, erstellen Sie zunächst in den gewünschten Sprachabschnitten Ihre Tags mit den Texten:

       <language name="de">

             <strIBAN>IBAN</strIBAN>

       </language>

Anschließend ersetzen Sie den Text im HTML durch einen Verweis auf den entsprechenden Abschnitt in der XML-Datei:

<xsl:value-of select="/template/language/strIBAN"/>

Um Ihr Template zu testen, bitten wir Sie folgende Zeilen nur für den Test (bevor Sie es an die First Cash Solution schicken) in Ihre XML-Datei zu integrieren und im Anschluss die XML-Datei in einem Browser aufzurufen. Wenn kein Fehler angezeigt wird, können Sie unserem Support Ihr Template und den Image-Ordner in einer Zip-Datei schicken, mit der Bitte es zu prüfen und einzuspielen.

<?xml version="1.0" encoding="UTF-16"?>

<?xml-stylesheet type="text/xsl" href="templatename.xsl"?>

<template>        <languages>bitte für Ihre Layout Tests weglassen              <language name="de">              </language>              <language name="en">              </language>        </languages> bitte für Ihre Layout Tests weglassen </template>

Um einen Überblick der Versionen zu erhalten, versehen Sie bitte den Namen Ihrer Zip-Datei mit Datum und Versions-Nummer.

2.4 Allgemeine Parameter der Schnittstelle

Die Schnittstelle für das 1cs Online Bezahlsystem-Formular ist für alle Anbindungen einheitlich die paysdd.aspx. Um eine Lastschriftahlung per Formular abzuwickeln, rufen Sie folgende URL auf:

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

Dieser erste Abschnitt erklärt jene Parameter, die für alle einzelnen Anbindungen einheitlich sind. Diese Werte sind immer zu übergeben, zuzüglich der in den nachfolgenden Abschnitten erläuterten speziellen Parameter für die jeweilige Anbindung. Ebenso sind hier in der zweiten Tabelle alle Antwortparameter erläutert, die ebenfalls für alle Lastschrift-Anbindungen einheitlich sind.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
MerchantIDans..30MHändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
Amountn..10MBetrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currencya3MWährung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
TransIDans..64MTransaktionsID, die für jede Zahlung eindeutig sein muss Bei Nutzung von Automandat (Befüllen von MandateID mit TransID oder RefNr) gilt der erlaubte Zeichensatz des Parameters MandateID.
ReqIDans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das 1cs Online Bezahlsystem keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs Online Bezahlsystem gelöscht.
OrderDescans..384MBeschreibung der gekauften Waren, Einzelpreise etc. Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. In Computop Analytics können Sie die kompletten Daten einsehen.
URLSuccessans..256MVollständige URL, die das 1cs Online Bezahlsystem aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter „response=encrypt“ zu verwenden, um eine verschlüsselte Antwort vom 1cs Online Bezahlsystem 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.
URLFailureans..256MVollständige URL, die das 1cs Online Bezahlsystem aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter „response=encrypt“ zu verwenden, um eine verschlüsselte Antwort vom 1cs Online Bezahlsystem 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.
Responsea7ODie Status-Rückmeldung, die das 1cs Online Bezahlsystem an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.
URLNotifyans..256MVollständige URL, die das 1cs Online Bezahlsystem aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter „response=encrypt“ zu verwenden, um eine verschlüsselte Antwort von 1cs Online Bezahlsystem 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. Im Fall einer Lastschrift-Zahlung und bei fehlerhaften Eingaben des Kunden können auf dem 1cs Online Bezahlsystem-Formular direkt ein bzw. mehrere Wiederholversuche stattfinden. Die Besonderheit ist hier, dass der Shop pro Zahlungsversuch direkt nach der Ausführung einen URLNotify-Aufruf erhält. Somit kann es sein, dass der Shop z.B. 3 Notifies mit identischer PayID erhält und dabei können unterschiedliche Status auftreten, welche entsprechend verarbeitet werden müssen.
UserDataans..256OWenn beim Aufruf angegeben, übergibt das 1cs Online Bezahlsystem die Parameter mit dem Zahlungsergebnis an den Shop
Captureans..6OBestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler. <Zahl>: Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).
expirationTimeans..19OZeitstempel für den Endzeitpunkt der Transaktionsverarbeitung, Angabe in UTC. Format: YYYY-MM-ddTHH:mm:ss
Plainans..50OEin von Händler zu setzender Wert, um Informationen wieder unverschlüsselt zurückzugeben, z.B. die MID. Da der „Plain“-Parameter Teil des verschlüsselten „Data“ im 1cs Online Bezahlsystem ist, ist dieser vor Manipulationen geschützt.
Customans..1024ODer „Custom“-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten „Data“ im 1cs Online Bezahlsystem Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.  Der Custom-Wert wird dann in Klartext an das 1cs Online Bezahlsystem-Antwort angehängt und dabei wird „|“ durch „&“ ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück. Custom=session=123|id=456 wird in der Antwort zu Session=123&id=456

Allgemeine Parameter für Lastschriftzahlungen per Formular

Um das Layout der SSL-Seite an den Shop anzupassen, können Sie mit den folgenden unverschlüsselten Parametern Farben, Schriften und Bilder konfigurieren:

KeyFormatCNDBeschreibung
AccBankans..20Ozur Vorbelegung des Lastschrift-Formulars: Name des Kreditinstituts des Kontoinhabers
AccOwnerans..50Ozur Vorbelegung des Lastschrift-Formulars: Name des Kontoinhabers
IBANans..34Mzur Vorbelegung des SEPA-Formulars: International Bank Account Number
BICans..11Ozur Vorbelegung des SEPA-Formulars: Bank Identifier Code
Languagea2 (enum)MSprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tschechisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> griechisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <tr> türkisch, <sp> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese Ohne Angabe ist die Sprache Deutsch.
Templateans..20MName der XSLT-Datei mit Ihrem individuellen Layout für das Bezahlformular. Wenn Sie das neugestaltete und abwärtskompatible First Cash Solution-Template nutzen möchten, übergeben Sie den Templatenamen „ct_compatible“. Wenn Sie das Responsive First Cash Solution-Template für mobile Endgeräte nutzen möchten, übergeben Sie den Templatenamen „ct_responsive“.
Backgroundans..256MFormular Hintergrundumgebung: – URL für ein Hintergrundbild – HTML-Farbwert für Hintergrundfarbe als HEX-Wert oder – HTML-Farbname
BGColorans..7MFormular Hintergrundfarbe: – HTML-Farbwert für Hintergrundfarbe als HEX-Wert oder – HTML-Farbname
BGImageans..256MFormular Hintergrundbild: – URL für ein Hintergrundbild Beachten Sie bitte, dass dieser Wert „BGColor“ überschreibt.
FColorans..6MTextfarbe: – HTML-Farbwert als HEX-Wert oder – HTML-Farbname
FFacea..10MHTML-Name der Schriftart
FSizen2MZahl für die Schriftgröße
URLBackans..256MVollständige URL, die das 1cs OBS aufruft, wenn der Kunde auf Abbruch klickt. Der Parameter „URLBack“ kann sowohl unverschlüsselt ans 1cs OBS übermittelt werden (Kompabilitätsmodus) als auch in den verschlüsselten Übergabeparametern (bevorzugte Variante) Wenn Sie Parameter/Werte in der URLBack übergeben möchten, so können Sie folgende Methode verwenden: URLBack=https://your.shop.com/back.php?param1%3Dvalue1%26param2%3Dvalue3%26status%3Dcancelled Wenn der Kunde auf Abbruch klickt, so wird die URL genauso aufgerufen, so dass Sie URL Decode verwenden können, um Parameter und Werte zu extrahieren.
tWidthans..4MBreite der Tabelle für die Eingabe der Kontodaten als Prozent- (50%) oder Pixelwerte (320)
tHeightans..4MHöhe der Tabelle für die Eingabe der Kontodaten als Prozent- (70%) oder Pixelwerte (480)
CustomField[n]ans..50OVom Händler individuell zu verwendendes Feld. Händler können bis zu 14 spezielle Felder (genannt CustomField1 bis CustomField14) in ihrer Zahlungsformularvorlage anpassen. CustomFields sind eine Funktion, mit der Sie zusätzliche Informationen wie Ihr Logo, Bestelldetails und Kundendetails auf dem Zahlungsformular anzeigen können. Sonderzeichen (wie &, ‚, <, >) sind nicht erlaubt – auch nicht „urlencoded“. Die Verwendung bzw. Darstellung der CustomField{n] ist abhängig vom verwendeten Template.

Layout-Parameter für 1cs OBS-Formulare bei Lastschriftzahlungen

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem 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. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 
KeyFormatCNDBeschreibung
MIDans..30MHändlerID, die von der First Cash Solution vergeben wird
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XIDan32MVom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Statusa..50MOK oder PENDING (URLSuccess) sowie FAILED (URLFailure)
Descriptionans..1024MNähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Coden8MFehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
IBANans..34OCnur ohne PBAN-Konfiguration: International Bank Account Number
BICans..11OBank Identifier Code
AccOwnerans..50OName des Kontoinhabers
AccBankans..20OName des Kreditinstituts des Kontoinhabers
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
UserDataans..1024OWenn beim Aufruf angegeben, übergibt das 1cs Online Bezahlsystem die Parameter mit dem Zahlungsergebnis an den Shop
Plainans..50OEin einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID. Da der „Plain“-Parameter Teil des verschlüsselten „Data“ im 1cs Online Bezahlsystem ist, ist dieser vor Manipulationen geschützt.
Customans..1024ODer „Custom“-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten „Data“ im 1cs Online Bezahlsystem Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.  Der Custom-Wert wird dann in Klartext an die 1cs Online Bezahlsystem-Antwort angehängt und dabei wird „|“ durch „&“ ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück. Custom=session=123|id=456 wird in der Antwort zu Session=123&id=456

Allgemeine Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure

2.5 Direktanbindung

Für die Direktanbindung zur Lastschrift sind neben den oben beschriebenen allgemeinen Parametern noch nachstehende Parameter zusätzlich an das Formular zu übergeben.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
refnrns..30OEindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
OrderDescans..384MBeschreibung der gekauften Waren, Einzelpreise etc. Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. Im Händler Cockpit können Sie die kompletten Daten einsehen.
OrderDesc2ans..384M2. Zeile der Warenbeschreibung, die auf dem Kontoauszug erscheint (27 Zeichen). Im Händler Cockpit können Sie die kompletten Daten einsehen.
Captureans..6OBestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler. <Zahl>: Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).
MandateIDans..35Cfür SEPA: SEPA-Mandatsnummer (Pflicht bei SEPA) sollte eindeutig sein, ist nicht case-sensitive Zulässige Zeichen: Ziffern 0-9, Großbuchstaben A-Z, Kleinbuchstaben a-z, Apostroph, Doppelpunkt, Fragezeichen, Komma, Punkt, Pluszeichen, Minuszeichen, Schrägstrich, linke und rechte Klammer
DtOfSgntrans..10Ofür SEPA: Datum der Mandatserteilung im Format DD.MM.YYYY (Pflicht bei Übergabe von MandateID)
MdtSeqTypeans..4Ofür SEPA: Gibt an, ob es sich um eine Erst-, Folge-, Einmal- oder letztmalige Lastschrift handelt. Zulässige Werte: FRST, RCUR, OOFF, FNAL Standard: OOFF (Einmal-Lastschrift)
PBANans..27Ofür SEPA: PseudoBankNumber. Die letzten drei Stellen sind identisch zu den letzten drei Stellen der IBAN

Zusätzliche Parameter für die direkte Lastschriftanbindung per Formular

Die folgende Tabelle beschreibt die zusätzlichen Ergebnis-Parameter, die das 1cs Online Bezahlsystem speziell bei der direkten Anbindung 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. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 
KeyFormatCNDBeschreibung
refnrns..30OEindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MandateIDans..35Ofür SEPA: SEPA-Mandatsnummer (Pflicht bei SEPA) sollte eindeutig sein, ist nicht case-sensitive Zulässige Zeichen: Ziffern 0-9, Großbuchstaben A-Z, Kleinbuchstaben a-z, Apostroph, Doppelpunkt, Fragezeichen, Komma, Punkt, Pluszeichen, Minuszeichen, Schrägstrich, linke und rechte Klammer
DtOfSgntrans..10Ofür SEPA: Datum der Mandatserteilung im Format DD.MM.YYYY (Pflicht bei Übergabe von MandateID)
MdtSeqTypeans..4Ofür SEPA: Gibt an, ob es sich um eine Erst-, Folge-, Einmal- oder letztmalige Lastschrift handelt. Zulässige Werte: FRST, RCUR, OOFF, FNAL Standard: OOFF (Einmal-Lastschrift)
PBANans..27Ofür SEPA: PseudoBankNumber. Die letzten drei Stellen sind identisch zu den letzten drei Stellen der IBAN

Zusätzliche Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure bei der direkten Anbindung

3 1cs Online Bezahlsystem Schnittstelle: Server-zu-Server

3.1 Diagramm zum Prozessablauf per Server-zu-Server

Beachten Sie für die grundlegenden Abläufe einer Server-zu-Server-Zahlung bitte auch die Erläuterungen im Handbuch Programmiergrundlagen.

Prozessablauf einer Lastschriftzahlung über die Server-zu-Server-Schnittstelle

3.2 Aufruf der Schnittstelle: allgemeine Parameter

Die Schnittstelle für Lastschriftzahlungen ist für alle Anbindungen einheitlich die edddirect.aspx. Um eine elektronische Lastschrift über eine Server-zu-Server-Verbindung auszuführen, rufen Sie folgende URL auf:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
MerchantIDans..30MHändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
Amountn..10MBetrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currencya3MWährung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
TransIDans..64MTransaktionsID, die für jede Zahlung eindeutig sein muss Bei Nutzung von Automandat (Befüllen von MandateID mit TransID oder RefNr) gilt der erlaubte Zeichensatz des Parameters MandateID.
AccBankans..20MBezeichnung Bank
AccOwnera..50MKontoinhaber
IBANans..34MInternational Bank Account Number
BICans..11OBank Identifier Code
ReqIDans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das 1cs Online Bezahlsystem keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs Online Bezahlsystem gelöscht.
UserDataans..256OWenn beim Aufruf angegeben, übergibt das 1cs Online Bezahlsystem die Parameter mit dem Zahlungsergebnis an den Shop
Captureans..6OBestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler. <Zahl>: Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

Allgemeine Parameter für Lastschriftzahlungen über Socket-Verbindung

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

  • es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
  • die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 
KeyFormatCNDBeschreibung
MIDans..30MHändlerID, die von der First Cash Solution vergeben wird
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XIDan32MVom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Statusa..50MOK oder PENDING (URLSuccess) sowie FAILED (URLFailure)
Descriptionans..1024MNähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Coden8MFehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
UserDataans..1024OWenn beim Aufruf angegeben, übergibt das 1cs Online Bezahlsystem die Parameter mit dem Zahlungsergebnis an den Shop
IBANans..34OInternational Bank Account Number
BICans..11OCnur bei PBAN-Erzeugung: PseudoBankNumber. Die letzten drei Stellen sind identisch zu den letzten drei Stellen der IBAN
AccOwnerans..50OCnur bei PBAN-Erzeugung: Kontoinhaber
AccBankans..20OCnur bei PBAN-Erzeugung: Bezeichnung der Bank
PBANans..27Onur bei PBAN-Erzeugung: PseudoBankNumber. Die letzten drei Stellen sind identisch zu den letzten drei Stellen der IBAN
MandateIDans..35OSEPA-Mandatsnummer
DtOfSgntrans..10ODatum der Mandatserteilung im Format DD.MM.YYYY

Allgemeine Ergebnis-Parameter für Lastschriftzahlungen über Socket-Verbindung

3.3 Direktanbindung

Für die Direktanbindung zur Lastschrift sind neben den oben beschriebenen allgemeinen Parametern noch nachstehende Parameter per Server-zu-Server-Verbindung zu übergeben.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
MandateIDans..35M
für SEPA: SEPA-Mandatsnummer (Pflicht bei SEPA) sollte eindeutig sein, ist nicht case-sensitive Zulässige Zeichen: Ziffern 0-9, Großbuchstaben A-Z, Kleinbuchstaben a-z, Apostroph, Doppelpunkt, Fragezeichen, Komma, Punkt, Pluszeichen, Minuszeichen, Schrägstrich, linke und rechte Klammer
DtOfSgntrans..10Ofür SEPA: Datum der Mandatserteilung im Format DD.MM.YYYY (Pflicht bei Übergabe von MandateID)
MdtSeqTypeans..4Ofür SEPA: Gibt an, ob es sich um eine Erst-, Folge-, Einmal- oder letztmalige Lastschrift handelt. Zulässige Werte: FRST, RCUR, OOFF, FNAL Standard: OOFF (Einmal-Lastschrift)
PBANans..27Ofür SEPA: PseudoBankNumber. Die letzten drei Stellen sind identisch zu den letzten drei Stellen der IBAN
Coden8MFehlercode gemäß 1cs OBS Antwort-Codes
UserDataans..1024OWenn beim Aufruf angegeben, übergibt das 1cs OBS die Parameter mit dem Zahlungsergebnis an den Shop.
RefNrns…30OEindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
OrderDescans..384MBeschreibung der gekauften Waren, Einzelpreise etc. Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. Im Händler Cockpit können Sie die kompletten Daten einsehen.
OrderDesc2ans..384M2. Zeile der Warenbeschreibung, die auf dem Kontoauszug erscheint (27 Zeichen). Im Händler Cockpit können Sie die kompletten Daten einsehen.
Zusatzparameter bei aktivierter DEVICERECOGNITION
DeviceIDans..50OEindeutige Geräte-ID
DRConfidencen..3OZuordnungsquote 0-100 (0=keine Zuordnung, 100=absolut sichere Zuordnung)
DRNewDeviceans..5OTrue / false
DRAnonProxyUsedans..5OTrue / false
DRProxyUsedans..5OTrue / false
DRCountryCodea2OLändercode zweistellig gemäß ISO 3166, ermittelt aus Geolocation-Daten, z.B. DE
DRCityans..50OStadt, ermittelt aus Geolocation-Daten, z.B. Frankfurt
DRLatitudeans..50OGeografische Breite, ermittelt aus Geolocation-Daten, z.B. 13,754
DRLongitudeans..50OGeografische Länge, ermittelt aus Geolocation-Daten, z.B. 100,5014
DRFSn..3OFraudscore, 0-100 (0=geringe Betrugswahrscheinlichkeit, 100=hohe Betrugswahrscheinlichkeit)
DRFSRulematchans..1024ORegeln, die der Zuordnung zum Fraudscore dienen
DRBrowserLanguagesans..255OListe der am Browser hinterlegten Sprachen
DRIsMobileDeviceans..5OTrue / false
Fraudans..50Oz.B. Fraud, Suspicion, NoFraud

Zusätzliche Parameter für Lastschriftzahlungen über Socket-Verbindung bei direkter Anbindung

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

  • es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
  • die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 
KeyFormatCNDBeschreibung
refnrns..30OEindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
MdtSeqTypea4Ofür SEPA: Gibt an, ob es sich um eine Erst-, Folge-, Einmal- oder letztmalige Lastschrift handelt. Zulässige Werte: FRST, RCUR, OOFF, FNAL Standard: OOFF (Einmal-Lastschrift)

4 Buchung / Gutschrift / Storno

4.1 Buchung

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Buchung (Capture) über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
MerchantIDans..30MHändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die zu buchende Zahlung
TransIDans..64MVom Händler initial vergebene ID für den zu buchenden Zahlungsvorgang
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
Amountn..10MBetrag in der kleinsten Währungseinheit (z.B. EUR Cent) Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currencya3MWährung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle
RefNrns..30MEindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
ReqIdans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs Online Bezahlsystem gelöscht.
MandateIDans..35Ofür SEPA: SEPA-Mandatsnummer (Pflicht bei SEPA) sollte eindeutig sein, ist nicht case-sensitive Zulässige Zeichen: Ziffern 0-9, Großbuchstaben A-Z, Kleinbuchstaben a-z, Apostroph, Doppelpunkt, Fragezeichen, Komma, Punkt, Pluszeichen, Minuszeichen, Schrägstrich, linke und rechte Klammer
DtOfSgntrans..10Ofür SEPA: Datum der Mandatserteilung im Format DD.MM.YYYY (Pflicht bei Übergabe von MandateID)

Parameter für Buchungen von Lastschriftzahlungen

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

  • es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
  • die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 
KeyFormatCNDBeschreibung
MIDans..30MHändlerID, die von der First Cash Solution vergeben wird
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XIDan32MVom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Statusa..50MOK (URLSuccess) oder FAILED (URLFailure)
Descriptionans..1024MNähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Coden8MFehlercode gemäß 1cs Online Bezahlsystem Antwort Codes
RefNrns..30OEindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).

Ergebnis-Parameter für Buchungen von Lastschriftzahlungen

4.2 Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Das 1cs Online Bezahlsystem erlaubt einerseits Gutschriften, die sich auf eine vorher über das 1cs Online Bezahlsystem getätigte Buchung beziehen, andererseits können Sie Gutschriften ohne Bezugstransaktion ausführen. Dieses Kapitel beschreibt die Abwicklung von Gutschriften mit Bezugstransaktion. Wenn Sie sich bei einer Gutschrift auf eine Buchung beziehen, dann ist die Höhe der Gutschrift auf die Höhe der vorangegangen Buchung beschränkt.

Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
MerchantIDans..30MHändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die gutzuschreibende Zahlung
TransIDans..64MVom Händler initial vergebene ID für den gutzuschreibenden Zahlungsvorgang
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
RefNrns..30CReferenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amountn..10MBetrag in der kleinsten Währungseinheit (z.B. EUR Cent) Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currencya3MWährung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle
ReqIdans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs Online Bezahlsystem gelöscht.

Parameter für Gutschrift von Lastschriftzahlungen

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

  • es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
  • die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 
KeyFormatCNDBeschreibung
MIDans..30MHändlerID, die von der First Cash Solution vergeben wird
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die gutzuschreibende Zahlung
XIDan32MVom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Statusa..50MOK (URLSuccess) oder FAILED (URLFailure)
Descriptionans..1024MNähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Coden8MFehlercode gemäß 1cs Online Bezahlsystem Antwort Codes
RefNrns..30CReferenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).

Ergebnis-Parameter für Gutschrift von Lastschriftzahlungen

4.3 Gutschrift ohne Referenz

Das 1cs Online Bezahlsystem kann für Sie Gutschriften ausführen, die sich nicht auf eine vorherige Buchung beziehen. In diesem Fall muss die Gutschrift als komplett neue Zahlungstransaktion an das 1cs Online Bezahlsystem übergeben werden. Um die beschriebene Zusatzfunktion nutzen zu können, nehmen Sie bitte mit dem 1cs Support Kontakt auf.

Hinweis: Bitte beachten Sie, dass Gutschriften ohne Bezug auf eine vorherige Buchung bei Ihrem Acquirer höhere Kosten verursachen. Wenn Sie häufig keinen Bezug auf die Buchung nehmen können, sollten Sie dies mit Ihrem Acquirer abstimmen.

Hinweis: Gutschrift ohne Referenz ist nur bei direkter Anbindung der Lastschrift möglich.

Um eine Gutschrift (Credit) ohne Referenztransaktion über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
MerchantIDans..30MHändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNrns..30OEindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amountn..10MBetrag in der kleinsten Währungseinheit (z.B. EUR Cent) Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currencya3MWährung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle
AccOwnerans..50OCnur bei PBAN-Erzeugung: Kontoinhaber
AccBankans..20OCnur bei PBAN-Erzeugung: Bezeichnung der Bank
IBANans..34OInternational Bank Account Number
BICans..11OCnur bei PBAN-Erzeugung: PseudoBankNumber. Die letzten drei Stellen sind identisch zu den letzten drei Stellen der IBAN
OrderDescans..768MBeschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.
ReqIDans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das 1cs Online Bezahlsystem keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs OnlineBezahlsystem gelöscht.
MACan64M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)  

Parameter für Gutschrift von Lastschriftzahlungen ohne Bezug

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

  • es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
  • die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 
KeyFormatCNDBeschreibung
MIDans..30MHändlerID, die von der First Cash Solution vergeben wird
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XIDan32MVom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Statusa..50MOK (URLSuccess) oder FAILED (URLFailure)
Descriptionans..1024MNähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Coden8MFehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)

Ergebnis-Parameter für Gutschrift von Lastschriftzahlungen ohne Bezug

4.4 Storno

Stornierungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Lastschriftzahlung über eine Server-zu-Server-Verbindung zu stornieren, verwenden Sie folgende URL:

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

Hinweis: Die Reverse.aspx macht nicht nur Autorisierungen, sondern IMMER DEN LETZTEN TRANSAKTIONSSCHRITT rückgängig! Falls die letzte Transaktion eine Buchung war, löst die Reverse.aspx z.B. eine Gutschrift aus. Es ist daher größte Vorsicht geboten, und die Nutzung erfolgt auf eigene Gefahr. Wir empfehlen, vor Nutzung der Reverse.aspx den Transaktionsstatus mit der Inquire.aspx prüfen.

Hinweis: Eine Stornierung ist nur bei direkter Anbindung der Lastschrift möglich.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
MerchantIDans..30MHändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die zu stornierende Zahlung
TransIDans..64MID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs
Amountn..10MBetrag in der kleinsten Währungseinheit (z.B. EUR Cent) Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currencya3MWährung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
ReqIdans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs Online Bezahlsystem gelöscht.

Parameter für Storno von Lastschriftzahlungen

Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

  • es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
  • die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 
KeyFormatCNDBeschreibung
MIDans..30MHändlerID, die von der First Cash Solution vergeben wird
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
XIDan32MVom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
Statusa..50MOK (URLSuccess) oder FAILED (URLFailure)
Descriptionans..1024MNähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Coden8MFehlercode gemäß 1cs Online Bezahlsystem Antwort Codes (Fehlercodes)

Ergebnis-Parameter für Storno von Lastschriftzahlungen

5 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.

5.1 Batch-Aufrufe und Antworten  

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

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

AktionVersionBeschreibung
Capture1.0 / 2.0Standardversion ohne Rückgabe von Parameter Code
1.x / 2.xmit RefNr (gilt für alle Versionen außer 1.0)
Authorize1.0.1 / 2.0.1Standardversion ohne Rückgabe von Parameter Code
1.x.1 / 2.x.1mit RefNr (gilt für alle Versionen außer 1.0)
Sale1.0.1 / 2.0.1Standardversion ohne Rückgabe von Parameter Code
1.x.1 / 2.x.1mit RefNr (gilt für alle Versionen außer 1.0)
Credit1.0 / 2.0Standardversion ohne Rückgabe von Parameter Code
1.x / 2.xmit RefNr (gilt für alle Versionen außer 1.0)
CreditEx1.0 / 2.0Standardversion ohne Rückgabe von Parameter Code
1.x / 2x.mit RefNr (gilt für alle Versionen außer 1.0)

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Lastschriftzahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

HEAD,<MerchantID>,<Date>,<Version> EDD,Authorize,<Amount>,<Currency>,<TransID>,(<RefNr>,)<AccOwner>,<IBAN>,<BIC>,<AccBankName>,<OrderDesc1>,<OrderDesc2>,(<MandateID>,<DtOfSgntr>,<MdtSeqType>) EDD,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>,)<AccOwner>,<IBAN>,<BIC>,<AccBankName>,<OrderDesc1>,<OrderDesc2>,(<MandateID>,<DtOfSgntr>,<MdtSeqType>) EDD,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<MandateID>,<DtOfSgntr>,<MdtSeqType>) EDD,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID> EDD,CreditEx,<Amount>,<Currency>,<TransID>,(<RefNr>,)<AccOwner>,<IBAN>,<BIC>,<AccBankName>,<OrderDesc1>,<OrderDesc2> EDD,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:

KeyFormatCNDBeschreibung
Typea..11MHEAD für Header, FOOT für Footer, EDD für Lastschrift
Actiona..20MDer Action-Parameter definiert die Art der Transaktion: Authorize (Autorisierung) Capture (Buchung) Sale (Verkauf) Credit (Gutschrift) CreditEx (Gutschrift ohne vorherige Buchung; bitte stimmen sie sich hierzu vorher mit dem First Cash Solution Support ab) Reverse (Storno)
Amountn..10MBetrag in der kleinsten Währungseinheit (z.B. EUR Cent) Bitte wenden Sie sich an den 1cs Support, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currencya3MWährung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für diese Transaktion
RefNrns..30OEindeutige Referenznummer Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie („Umlaute“, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
AccOwnerans..50MKontoinhaber
IBANans..34MInternational Bank Account Number
BICans..11OBank Identifier Code
AccBankNameans..20MName der Bank
OrderDesc1ans..27MVerwendungszweck-Text für Kontoauszug des Kunden, max. 27 Zeichen
OrderDesc2ans..27MVerwendungszweck-Text für Kontoauszug des Kunden, max. 27 Zeichen (2. Zeile)
MandateIDans..35OSEPA-Mandatsnummer (Pflicht bei SEPA) sollte eindeutig sein, ist nicht case-sensitive Zulässige Zeichen: Ziffern 0-9, Großbuchstaben A-Z, Kleinbuchstaben a-z, Apostroph, Doppelpunkt, Fragezeichen, Komma, Punkt, Pluszeichen, Minuszeichen, Schrägstrich, linke und rechte Klammer
DtOfSgntrans..10ODatum der Mandatserteilung im Format DD.MM.YYYY (Pflicht bei Übergabe von MandateID)
MdtSeqTypeans..4OGibt an, ob es sich um eine Erst-, Folge-, Einmal- oder letztmalige Lastschrift handelt. Zulässige Werte: FRST, RCUR, OOFF, FNAL Standard: OOFF (Einmal-Lastschrift)

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>

EDD,Authorize,<Amount>,<Currency>,<TransID>,(<RefNr>,)<AccOwner>,<IBAN>,<BIC>,<AccBankName>,<OrderDesc1>,<OrderDesc2>,(<MandateID>,<DtOfSgntr>,<MdtSeqType>,)<Status>,<Code>

EDD,Sale,<Amount>,<Currency>,<TransID>,(<RefNr>,)<AccOwner>,<IBAN>,<BIC>,<AccBankName>,<OrderDesc1>,<OrderDesc2>,(<MandateID>,<DtOfSgntr>,<MdtSeqType>,)<Status>,<Code> EDD,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,(<MandateID>,<DtOfSgntr>,<MdtSeqType>,)<Status>,<Code> EDD,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code> EDD,CreditEx,<Amount>,<Currency>,<TransID>,(<RefNr>,)<AccOwner>,<IBAN>,<BIC>,<AccBankName>,<OrderDesc1>,<OrderDesc2>,<Status>,<Code> EDD,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):

KeyFormatCNDBeschreibung
Actiona..20MDer Action-Parameter definiert die Art der Transaktion wie Capture (Buchung) oder Credit (Gutschrift) – siehe oben.
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.
Statusa..50MOK (URLSuccess) oder FAILED (URLFailure)
Coden8MFehlercode gemäß 1cs Online Bezahlsystem Antwort Codes. (Fehlercodes)

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien