Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEWORK and version Dokumentation
Table of Contents


Über giropay

Allgemeines zu giropay

giropay ist ein Standard, den Sparkassen, Postbank sowie Volks- und Raiffeisenbanken gegründet haben. Die giropay Online-Überweisung hat für den Händler gleich mehrere Vorteile: Zum einen gewährt giropay dem Verkäufer eine Zahlungsgarantie bis 10.000 Euro, zum anderen ist die Überweisung eine Vorauszahlung, die das Zahlungsziel minimiert. Und nicht zuletzt nutzt der Kunde das ihm bekannte und vertrauenswürdige Online-Banking seines eigenen Kreditinstitutes – genau wie beim Online-Banking.

Im ersten Schritt wählt der Kunde im Online-Shop an der Kasse die Zahlungsmethode giropay und wählt sein Kreditinstitut aus. Er wird dann direkt mit seiner Sparkasse oder Bank verbunden und meldet sich wie gewohnt mit seiner PIN an. Daraufhin erscheint ein vorausgefüllter Überweisungsträger, so dass der Kunde nur noch seine TAN eingeben muss, um die Zahlung zu bestätigen.

Wie beim Online-Banking üblich, sind auch bei der Online-Überweisung die übermittelten Daten mit SSL (Secure Sockets Layer) verschlüsselt und so gegen Manipulation gesichert.


Page properties
Logo

Info
Excerpt
giropay ist eine Online-Überweisung mit PIN und TAN, die Ihnen Zugang zu fast 40 Millionen deutschen und österreichischen Online-Banking-Nutzern verschafft. Zusätzlich zu der 100%-Zahlungsgarantie ist die Nutzung von giropay auch relativ günstig.
TypZahlungen per Onlineüberweisung

Weitere Informationen finden Sie auch auf der Webseite von giropay (http://www.giropay.de).


Diagramm zum Prozessablauf

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameProcessFlow
DisableCachingtrue
PageWithExcerptEN:giropay

giropay Prozessablauf


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
-Schnittstelle

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameDefinition
PageWithExcerptDefinition DE


Aufruf der giropay-Schnittstelle

Um eine Zahlung per Online-Überweisung mit giropay abzuwickeln, rufen verwenden Sie bitte folgende URL auf:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording
giropay.aspx


Hinweis: Bitte beachten Sie, dass eine Anbindung im Shop per iFrame aufgrund von Regularien nicht möglich ist und technisch verhindert wird.

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623065180928_-37847400
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamegiropay_request
PageWithExcerptEN:giropay

Parameter für Online-Überweisungen mit giropay


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

Table Filter
ddSeparatorstrue
inversefalse
defaultDescription
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1628076402389_430107094
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamegiropay_response
PageWithExcerptEN:giropay

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


Prüfung des Online-Status von giropay-Banken

Im

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
können Händler vor dem eigentlichen Zahlungsablauf prüfen, welche Banken online sind und somit die giropay-Zahlung ermöglichen. Für diese Prüfung rufen verwenden Sie bitte folgende URL auf:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording
giropayList.aspx


Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623065566295_-1806624567
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameverification_request
PageWithExcerptEN:giropay

Parameter für zur Prüfung des Online-Status von giropay-Banken


Bitte übergeben Sie die Merchant-ID sowohl im unverschlüsselten als auch im verschlüsselten String.


Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
als Antwort sendet:

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623065625018_1544747724
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameverification_response
PageWithExcerptEN:giropay

Ergebnis-Parameter zur Abfrage der giropay-Banken



Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Das

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
erlaubt für giropay nur Gutschriften, die sich auf eine vorher über das
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
getätigte Buchung beziehen. Die Höhe der Gutschrift ist auf die Höhe der vorangegangen Buchung beschränkt.

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

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording
credit.aspx


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623065782102_1879573835
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamecredit_request
PageWithExcerptEN:giropay

Parameter für Gutschrift von giropay-Zahlungen


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623065851662_904340516
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamecredit_response
PageWithExcerptEN:giropay

Ergebnis-Parameter für Gutschrift von giropay-Zahlungen


Batch-Nutzung der Schnittstelle

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

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

Hinweis: Beachten Sie bitte, dass eine Batch-Nutzung für giropay nur über die PPRO-Anbindung möglich ist.

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

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623066001964_-1492829433
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamebatch_versions
PageWithExcerptEN:giropay

Beschreibung der möglichen Batch-Versionen


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

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamebatch_structure
PageWithExcerptEN:giropay


Beispiel für Master MID Funktion:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamebatch_MasterMid
PageWithExcerptEN:giropay


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBatch_Request_Intro
PageWithExcerptReuse API
Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623066049255_-695903923
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamebatch_request
PageWithExcerptEN:giropay

Beschreibung der Felder im Datensatz von Batch-Dateien


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

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamebatch_Response
PageWithExcerptEN:giropay
Die


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBatch_Response_Intro
PageWithExcerptReuse API
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):

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623066115854_94067418
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamebatch_response
PageWithExcerptEN:giropay

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien