Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- girocheckout:eps:start [2019/09/03 17:51]
michaelheumann
+++ girocheckout:eps:start [2023/04/26 21:23]
michaelheumann
@@ Zeile 1: / Zeile 1: @@
 ~~NOCACHE~~
 ====== eps ======
-Informationen zu eps sind unter https://www.girosolution.de/girocheckout/fuer-haendler/ zu finden.
 eps kann **ausschließlich** mit der Währung **EURO** verwendet werden.
@@ Zeile 22: / Zeile 20: @@
 autonumber
-customer -> shop:
+customer -> shop:
-shop -> girocheckout:
-girocheckout -> shop:
 shop -> girocheckout:
 girocheckout -> eps:
@@ Zeile 30: / Zeile 26: @@
 girocheckout -> shop:
 shop -> customer:
-customer -> bank:
+customer -> eps:
+eps -> bank:
 bank -> customer:
 customer -> bank:
@@ Zeile 47: / Zeile 44: @@
   - Käufer/Kunde wählt eps und gibt BIC seiner Bank ein
-  - Shop prüft Bankstatus ([[girocheckout:eps:start#bankstatus_prüfen|Bankstatus prüfen]])
-  - Shop bekommt Rückmeldung, ob Bank eps unterstützt
   - Shop initiiert eps Transaktion ([[girocheckout:eps:start#initialisierung_einer_eps_zahlung|Initialisierung]])
   - GiroCheckout initialisiert Transaktion bei eps
@@ Zeile 54: / Zeile 49: @@
   - Shop bekommt Rückmeldung über Initialisierungsausgang (bei Fehler ist Transaktion beendet)
   - Shop sendet Redirect URL an Käufer-/Kundenbrowser
-  - Käufer-/Kundenbrowser leitet zum Online-Banking weiter
+  - Käufer-/Kundenbrowser leitet zu eps weiter, wo die Bankauswahl erfolgt (optional, falls nicht schon im Browser gesp[eichert)
+  - eps leitet dann an das Online-Banking der entsprechenden Bank weiter
   - Online-Banking zeigt Loginseite an
   - Käufer/Kunde autorisiert Transaktion
@@ Zeile 93: / Zeile 89: @@
 |merchantId     |Ja       |Integer   |Händler-ID eines eps Projekts |
 |projectId      |Ja       |Integer   |Projekt-ID eines eps 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 161: / Zeile 157: @@
 |merchantId     |Ja       |Integer     |Händler-ID eines eps Projekts |
 |projectId      |Ja       |integer     |Projekt-ID eines eps Projekts |
-|merchantTxId   |Ja       |String(255) |eindeutige Transaktions-ID des Händlers |
+|merchantTxId   |Ja       |String(255) |eindeutige Transaktions-ID des Händlers. Zulässige Zeichen: beliebige Buchstaben (inkl. sprachl. Sonderzeichen), 0-9, Zeichen & = + , : ; . _ ! ? # /  |
 |amount         |Ja       |Integer     |Bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny |
 |currency       |Ja       |String(3)   |Währung der Transaktion\\ EUR = Euro|
 |purpose        |Ja       |String(27)  |Verwendungszweck der eps Überweisung |
-|bic            |**deprecated** |String(11)  |**Dieser Parameter darf nicht mehr verwendet werden, alle eps-Transaktionen werden jetzt mit einer externen Bankenabfrage durchgeführt!** 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 eps-Transaktionen werden jetzt mit einer externen Bankenabfrage durchgeführt!** BIC der Käuferbank (8 oder 11-stellig)|
-|urlRedirect    |Ja       |String      |URL, an die der Kunde nach der Zahlung geschickt werden soll. |
+|urlRedirect    |Ja       |String(2048) |URL, an die der Kunde nach der Zahlung geschickt werden soll. |
-|urlNotify      |Ja       |String      |URL, an die der Zahlungsausgang gemeldet werden soll. |
+|urlNotify      |Ja       |String(2048) |URL, an die der Zahlungsausgang gemeldet werden soll. |
+|kassenzeichen  |Optional |String(255)  |Optionales Feld für die Übergabe eines Kassenzeichens.  Dieses wird dann im GiroCockpit in den Transaktionsdetails angezeigt (und bald auch exportiert) und es kann dort auch danach gesucht werden.  Zulässige Zeichen sind alle UTF-8-Zeichen. |
 |hash           |Ja       |String      |HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
@@ Zeile 242: / Zeile 239: @@
 |gcHash           |Ja      |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
-===== Bankauswahl Widget =====
+===== Senderinformationen abrufen =====
-{{page>girocheckout:widget&noheader&nofooter}}
+Mit dieser Funktion können die Senderinformationen einer erfolgreich durchgeführten Transaktion abgerufen werden. Anhand der angegebenen Referenz wird Kontoinhaber, IBAN und BIC des Absenders geliefert.  Diese Information kann dann für eine Rücküberweisung an den Zahler genutzt werden.
+=== API-Aufruf ===
+**URL:** https://payment.girosolution.de/girocheckout/api/v2/eps/senderinfo \\
+**Bereitzustellen von:** GiroCheckout \\
+**Aufzurufen von:** Händler
+== POST-Parameter ==
+^Name           ^Pflicht  ^Type      ^Beschreibung   ^
+|merchantId     |Ja       |Integer   |Händler-ID eines eps Projekts |
+|projectId      |Ja       |Integer   |Projekt-ID eines eps Projekts |
+|reference      |Ja       |String(36)|GiroCheckout Transaktions-ID |
+|hash           |Ja       |String(32)|HMAC MD5 hash über alle Werte des Aufrufs (siehe [[girocheckout:general:start#hash_generieren|hash generieren]])|
+== Beispiel ==
+{{page>codesamples:eps#senderinfo.request&noheader&nofooter}}
+=== Antwort ===
+Die Antwort besteht aus einem JSON Objekt. Das Feld rc liefert einen Fehlercode. Wird **rc = 0** zurückgeliefert, enthalten die entsprechenden Felder die Senderinformationen.
+== JSON-Parameter ==
+^Name           ^Pflicht  ^Type      ^Beschreibung   ^
+|rc             |Ja       |Integer   |[[girocheckout:errorcodes|Fehlernummer]] |
+|msg            |Ja       |String    |zusätzliche Informationen im Fehlerfall |
+|accountholder  |Optional |String    |Inhaber des Absenderkontos|
+|iban           |Optional |String    |IBAN des Absenderkontos |
+|bic            |Optional |String    |BIC des Absenderkontos |
+^HEADER Parameter^^^^
+|hash           |Ja       |String    |HMAC MD5 hash über alle Werte der Rückmeldung. Siehe [[girocheckout:general:start#uebermittlung_von_daten_ueber_einen_schnittstellenaufruf_an_den_haendler|hash der Rückantwort]] |
+== Beispiel im Erfolgsfall ==
+{{page>codesamples:eps#senderinfo.response.true&noheader&nofooter}}
+== Beispiel im Fehlerfall ==
+{{page>codesamples:eps#senderinfo.response.false&noheader&nofooter}}

Girocheckout API

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge