Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- girocheckout:giropay-id-kvs:start [2016/03/16 16:51]
thorstenmarx
+++ girocheckout:giropay-id-kvs:start [2019/09/03 18:01]
michaelheumann
@@ Zeile 83: / Zeile 83: @@
   - Bezahlinformation mit Käuferbrowserweiterleitung zurück zum Händler (durch Käufer nach Zahlung ausgelöst)
-Im Folgenden werden die API-Felder und Aufrufe näher erleutert.
+Im Folgenden werden die API-Felder und Aufrufe näher erläutert.
 ==== Bankstatus prüfen ====
+**Dieser Aufruf sollte nicht mehr verwendet werden, alle giropay-Transaktionen werden jetzt mit einer externen Bankenabfrage durchgeführt!**
 Es wird geprüft ob eine Bank giropay-ID Kontoverifikation unterstützt. Diesbezüglich wird die BIC des Käufer-Girokontos übermittelt. Die Antwort zeigt ob eine giropay-ID Kontoverifikation Abfrage möglich ist. Es wid empfohlen vor jeder Initiierung einer giropay-ID Kontoverifikation Abfrage den Bankstatus zu prüfen, da dadurch unnötige Abbrüche verhindert werden können.
@@ Zeile 96: / Zeile 99: @@
 |merchantId     |Ja       |Integer   |Händler-ID eines giropay-ID Kontoverifikation Projekts |
 |projectId      |Ja       |Integer   |Projekt-ID eines giropay-ID Kontoverifikation Projekts |
-|bic            |Ja       |String(11)|BIC der Käuferbank (8 oder 11-stellig), die geprüft werden soll (durch [[tools:bankstatus_widget|Bankauswahl Widget]] ermittelbar)|
+|bic            |Ja       |String(11)|BIC der Käuferbank (8 oder 11-stellig), die geprüft werden soll|
 |hash           |Ja       |String(32)|HMAC MD5 hash über alle Werte des Aufrufs (siehe [[girocheckout:general:start#hash_generieren|hash generieren]])|
@@ Zeile 125: / Zeile 128: @@
 ==== giropay Bankenabfrage ====
+**Dieser Aufruf sollte nicht mehr verwendet werden, alle giropay-Transaktionen werden jetzt mit einer externen Bankenabfrage durchgeführt!**
 Gibt eine Liste zurück, welche alle giropay-ID Kontoverifikation Banken enthält. Aus dieser Bankenliste muss der Käufer seine Bank auswählen.
@@ Zeile 155: / Zeile 160: @@
-==== Initialisierung einer giropay-ID Altersverifikation ====
+==== Initialisierung einer giropay-ID Kontoverifikation ====
-Durch eine erfolgreiche Initialisierung wird eine Referenznummer erstellt sowie ein Weiterleitunslink (redirect) an den Händler übermittelt. Der übermittelte Link führt zum Onlinebanking des Käufers. Er muss an diese URL weitergeleitet werden. Dies kann durch einen HTTP-Redirect-Header, eine HTML-Seite mit entsprechendem Meta-Tag oder Javascript erfolgen.
+Durch eine erfolgreiche Initialisierung wird eine Referenznummer erstellt sowie ein Weiterleitungslink (redirect) an den Händler übermittelt. Der übermittelte Link führt zum Onlinebanking des Käufers. Er muss an diese URL weitergeleitet werden. Dies kann durch einen HTTP-Redirect-Header, eine HTML-Seite mit entsprechendem Meta-Tag oder Javascript erfolgen.
 === Anfrage ===
@@ Zeile 169: / Zeile 174: @@
 |projectId      |Ja       |integer     |Projekt-ID eines giropay Projekts |
 |merchantTxId   |Ja       |String(255) |eindeutige Transaktions-ID des Händlers |
-|bic            |Optional |String(11)  |BIC der Käuferbank (8 oder 11-stellig) (durch [[tools:bankstatus_widget|Bankauswahl Widget]] ermittelbar)|
+|bic            |**deprecated** |String(11)  |**Dieser Parameter darf nicht mehr verwendet werden, alle giropay-Transaktionen werden jetzt mit einer externen Bankenabfrage durchgeführt!** BIC der Käuferbank (8 oder 11-stellig) |
 |iban           |Optional |String(34)  |IBAN der zu prüfenden Kontoverbindung **ohne Leerzeichen**|
 |info1Label     |Optional |String(30)  |zusätzliche Information zur Anzeige im Online Banking (Feldname) |
@@ Zeile 216: / Zeile 221: @@
 Der Ausgang einer Kontoverifikation wird an die im //urlNotify// Paramter angegebene URL übermittelt. Diese Rückmeldung dient dazu, dem Händler den Ausgang der Transaktion mitzuteilen. Durch diese Information kann der Transaktionsstatus beim Händler geändert werden.
-Der Zahlungausgang der giropay Transaktion steht im Feld gcResultPayment. Wurde zusätzlich die giropay-ID Überprüfung angefordert, steht das Ergebnis der Altersprüfung im Feld gcResultAVS.
+Der Transaktionsausgang der giropay-ID Kontoverifikation steht im Feld gcResultAVS.
 Aufgrund des giropay Ablaufes findet **keine automatische Rückleitung des Käufers** an die im Parameter //urlRedirect// angegebene URL statt. Eine Weiterleitung erfolgt erst, wenn der Käufer den "Abbrechen" oder "Zurück zum Shop" Button drückt.
@@ Zeile 227: / Zeile 232: @@
 == GET Parameter ==
-^Name           ^Pflicht  ^^^Type        ^Beschreibung   ^
+^Name           ^Pflicht  ^Type        ^Beschreibung   ^
-^           ^giropay^giropay-ID^giropay+giropay-ID  ^        ^   ^
+|gcReference      |Ja      |String      | GiroCheckout Transaktions-ID |
-|gcReference      |Ja      |Ja      |Ja       |String      | GiroCheckout Transaktions-ID |
+|gcMerchantTxId   |Ja      |String      | Händler Transaktions-ID |
-|gcMerchantTxId   |Ja      |Ja      |Ja       |String      | Händler Transaktions-ID |
+|gcBackendTxId    |Ja      |String      | Zahlungsabwickler Transaktions-ID |
-|gcBackendTxId    |Ja      |Ja      |Ja       |String      | Zahlungsabwickler Transaktions-ID |
+|gcResultPayment  |Optional|Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebniscodes der giropay Zahlung]]|
-|gcAmount         |Ja      |        |Ja       |Integer     | bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent |
+|gcResultAVS      |Ja      |Integer     | [[girocheckout:resultcodes#kontoverifikation|Ergebniscodes der giropay Kontoverifikation]] |
-|gcCurrency       |Ja      |        |Ja       |String      | Währung |
+|gcAccountHolder  |Ja      |String      | Kontoinhaber des verifizierten Kontos |
-|gcResultPayment  |Ja      |        |Ja       |Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebniscodes der giropay Zahlung]]|
+|gsAccountIban    |Ja      |String      | IBAN des verifizierten Kontos |
-|gcResultAVS      |        |Ja      |Ja       |Integer     | [[girocheckout:resultcodes#altersverifikation|Ergebniscodes der giropay Altersverifikation]] |
+|gsAccountBic     |Ja      |String      | BIC des verifizierten Kontos |
-|gcObvName        | |Optional |Optional |String | Optional zuschaltbares Feld, welches den Namen der zu verifizierenden Person beinhaltet (giropay-ID) |
+|gcHash           |Ja      |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
-|gcHash           |Ja      |Ja      |Ja       |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
 === Antwort ===
@@ Zeile 248: / Zeile 252: @@
 ==== Rückleitung des Kunden zum Händler ====
-Nach Beendigung der giropay Zahlung kann der Kunde über einen Link zurück zum Händler kommen. Eine Weiterleitung erfolgt erst, wenn der Käufer den „Abbrechen“ oder „Zurück zum Shop“ Button drückt. Diese Rückleitung erfolgt nicht automatisch.
+Nach Beendigung der giropay-ID Kontoverifikation kann der Kunde über einen Link zurück zum Händler kommen. Eine Weiterleitung erfolgt erst, wenn der Käufer den „Abbrechen“ oder „Zurück zum Shop“ Button drückt. Diese Rückleitung erfolgt nicht automatisch.
 === Anfrage ===
@@ Zeile 256: / Zeile 260: @@
 == GET Parameter ==
-^Name           ^Pflicht  ^^^Type        ^Beschreibung   ^
+^Name           ^Pflicht  ^Type        ^Beschreibung   ^
-^           ^giropay^giropay-ID^giropay+giropay-ID  ^        ^   ^
+|gcReference      |Ja      |String      | GiroCheckout Transaktions-ID |
-|gcReference      |Ja      |Ja      |Ja       |String      | GiroCheckout Transaktions-ID |
+|gcMerchantTxId   |Ja      |String      | Händler Transaktions-ID |
-|gcMerchantTxId   |Ja      |Ja      |Ja       |String      | Händler Transaktions-ID |
+|gcBackendTxId    |Ja      |String      | Zahlungsabwickler Transaktions-ID |
-|gcBackendTxId    |Ja      |Ja      |Ja       |String      | Zahlungsabwickler Transaktions-ID |
+|gcResultPayment  |Optional|Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebniscodes der giropay Zahlung]]|
-|gcAmount         |Ja      |        |Ja       |Integer     | bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent |
+|gcResultAVS      |Ja      |Integer     | [[girocheckout:resultcodes#kontoverifikation|Ergebniscodes der giropay-ID Kontoverifikation]] |
-|gcCurrency       |Ja      |        |Ja       |String      | Währung |
+|gcHash           |Ja      |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
-|gcResultPayment  |Ja      |        |Ja       |Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebniscodes der giropay Zahlung]]|
-|gcResultAVS      |        |Ja      |Ja       |Integer     | [[girocheckout:resultcodes#altersverifikation|Ergebniscodes der giropay Altersverifikation]] |
-|gcObvName        | |Optional | Optional|String | Optional zuschaltbares Feld, welches den Namen der zu verifizierenden Person beinhaltet (giropay-ID) |
-|gcHash           |Ja      |Ja      |Ja       |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |

Girocheckout API

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge