-Schnittstelle: per Formular

Diagramm zum Prozessablauf per Formular

Prozessablauf einer Lastschriftzahlung über die Formular-Schnittstelle

Corporate Paypage

Die -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 kopiert dieses XSLT-Template auf unseren -Server. Wenn Sie den Namen Ihrer XSLT-Datei im Parameter Template übergeben, erscheint das -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:

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 Bezahlseite an, zum Beispiel: paysdd.aspx?MerchantID=IhreMID&Len=123&Data=ABCFED…ACEF&template=IhreMerchantID

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>

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“

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.

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 die Parameter für die Übergabe, z. B. der SessionID zu verwenden.

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.

Link mit -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 -Logo wie auf dem Standardformular umgesetzt oder zeigen einen kleinen Impressum-Link an. Das -Logo können Sie auf www.computop.de/downloads abrufen.

Beide Informationen müssen auf die -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"/>

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="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 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.

Allgemeine Parameter der Schnittstelle

Die Schnittstelle für das -Formular ist für alle Anbindungen einheitlich die paysdd.aspx. Um eine Lastschriftahlung per Formular abzuwickeln, verwenden Sie bitte folgende URL:

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.

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:

Layout-Parameter für -Formulare bei Lastschriftzahlungen

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

Direktanbindung

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

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

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

EVO Payments

Für die Lastschriftanbindung über EVO Payments sind neben den oben beschriebenen allgemeinen Parametern noch nachstehende Parameter zusätzlich an das Formular zu übergeben.

Zusätzliche Parameter für die Lastschriftanbindung EVO Paymernts per Formular

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

InterCard

Die Lastschrift über Intercard bietet keine Zahlungsabsicherung. Wenn Sie eine Lastschrift mit Zahlungsabsicherung nutzen wollen, müssen Sie bei Intercard die Zahlungsart PayMorrow bestellen und implementieren.

Für die Lastschriftanbindung über InterCard sind neben den oben beschriebenen allgemeinen Parametern noch nachstehende Parameter zusätzlich an das Formular zu übergeben.

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

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

PPRO

Für die Lastschriftanbindung über PPRO sind neben den oben beschriebenen allgemeinen Parametern noch nachstehende Parameter zusätzlich an das Formular zu übergeben.

Hinweis: Bitte beachten Sie, dass der Standardparameter OrderDesc bei PPRO nicht weitergegeben wird.

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

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

-Schnittstelle: per Server-zu-Server

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

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, verwenden Sie bitte folgende URL:

edddirect.aspx

 

Allgemeine Parameter für Lastschriftzahlungen über Socket-Verbindung

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

Direktanbindung

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

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

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

EVO Payments

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

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

Zusätzliche Ergebnis-Parameter für Lastschriftzahlungen über Socket-Verbindung bei Anbindung EVO Payments

InterCard

Die Lastschrift über Intercard bietet keine Zahlungsabsicherung. Wenn Sie eine Lastschrift mit Zahlungsabsicherung nutzen wollen, müssen Sie bei Intercard die Zahlungsart PayMorrow bestellen und implementieren.

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

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

Zusätzliche Ergebnis-Parameter für Lastschriftzahlungen über Socket-Verbindung bei der Anbindung InterCard

PPRO

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

Hinweis: Bitte beachten Sie, dass der Standardparameter OrderDesc bei PPRO nicht weitergegeben wird.

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

Buchung / Gutschrift / Storno

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:

capture.aspx

 

Hinweis: Bei der Anbindung PPRO ist keine separate Buchung möglich, weil alle Transaktionen direkt als Sale-Transaktion ausgeführt werden.

Parameter für Buchungen von Lastschriftzahlungen

Ergebnis-Parameter für Buchungen von Lastschriftzahlungen

Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Das erlaubt einerseits Gutschriften, die sich auf eine vorher über das 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:

credit.aspx

 

Parameter für Gutschrift von Lastschriftzahlungen

Ergebnis-Parameter für Gutschrift von Lastschriftzahlungen

Gutschrift ohne Referenz

Das 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 übergeben werden. Um die beschriebene Zusatzfunktion nutzen zu können, nehmen Sie bitte mit dem 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:

eddcreditex.aspx

 

Parameter für Gutschrift von Lastschriftzahlungen ohne Bezug

Ergebnis-Parameter für Gutschrift von Lastschriftzahlungen ohne Bezug

Gutschrift ohne Referenz für Intercard

Das 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 übergeben werden. Um die beschriebene Zusatzfunktion nutzen zu können, nehmen Sie bitte mit dem 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.

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

eddcreditex.aspx

 

Parameter für Gutschrift von Lastschriftzahlungen ohne Bezug bei Intercard

Ergebnis-Parameter für Gutschrift von Lastschriftzahlungen ohne Bezug bei Intercard

Storno

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

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 Rever-se.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.

Parameter für Storno von Lastschriftzahlungen

Ergebnis-Parameter für Storno von Lastschriftzahlungen

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.

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.

Die tatsächlich per Batch möglichen Aktionen hängen von der jeweiligen Anbindung ab. Während bei direkter Anbindung alle Transaktionen einschließlich Gutschrift ohne Referenz möglich sind, sind bei den anderen Anbindungen EVO Payments, InterCard und PPRO keine Stornierung und keine Gutschrift ohne Referenz möglich. Bei PPRO erfolgen die Transaktionen zudem als reine Sale-Transaktionen, so dass dort nur Sale und Gutschrift möglich sind.

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

Beschreibung der möglichen Batch-Versionen

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

Beispiel für Master-MID-Funktion:

Beschreibung der Felder im Datensatz von Batch-Dateien

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

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien