Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- girocheckout:ideal:start [2015/12/03 18:24]
thorstenmarx [iDEAL]
+++ girocheckout:ideal:start [2022/02/25 21:48]
michaelheumann [iDEAL]
@@ Zeile 1: / Zeile 1: @@
+~~NOCACHE~~
 ====== iDEAL ======
-Informationen zu iDEAL sind unter https://www.girosolution.de/girocheckout/fuer-haendler/ zu finden.
 ===== Testdaten =====
@@ Zeile 121: / Zeile 120: @@
 |merchantId     |Ja       |Integer     |Händler-ID eines iDEAL Projekts |
 |projectId      |Ja       |integer     |Projekt-ID eines iDEAL 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     |Betrag in Cent\\ Wenn kind = 2, dann als Betrag 0 angeben |
 |currency       |Ja       |String(3)   |Währung der Transaktion\\ EUR = Euro (default) |
 |purpose        |Ja       |String(27)  |Verwendungszweck der iDEAL Überweisung |
-|issuer         |Ja       |String      |iDEAL Issuer Bank |
+|issuer         |Optional       |String      |iDEAL Issuer Bank. Wenn nicht angegeben, wird zu einer Bankauswahlseite weitergeleitet. |
 |urlRedirect    |Ja       |String      |URL, an die der Kunde nach der Zahlung geschickt werden soll. |
 |urlNotify      |Ja       |String      |URL, an die der Zahlungsausgang gemeldet werden soll. |
@@ Zeile 198: / Zeile 197: @@
 |gcResultPayment  |Ja       |Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebnis der iDEAL Zahlung]]|
 |gcHash           |Ja       |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
+===== Weitere Transaktionsarten =====
+Diese Transaktionen referenzieren auf eine zuvor erfolgte Transaktion. Die Transaktion basiert auf einer Server-zu-Server-Kommunikation und erfordert keine Kundenaktion (Eingabe von Daten).
+Bereitzustellen von: GiroCheckout \\
+Aufzurufen von: Händler \\
+==== Workflow ====
+<uml>
+hide footbox
+participant "Shop" as shop
+participant "GiroCheckout" as girocheckout
+participant "IcePay" as ip
+autonumber
+shop -> girocheckout:
+girocheckout -> ip:
+ip -> girocheckout:
+girocheckout -> shop:
+center footer (c)2016 by GiroSolution AG
+</uml>
+  - Shop sendet referenzierende Transaktion
+  - GiroCheckout leitet Transaktion zu Abwickler
+  - Abwickler übermittelt Ergebnis an GiroCheckout
+  - Shop bekommt Rückmeldung über Transaktionsausgang ([[girocheckout:ideal:start#benachrichtigung_ueber_den_zahlungsausgang|Benachrichtigung]])
+==== Erstattung (REFUND) ====
+{{page>girocheckout:transactiontypes:descriptions#refund.desc&noheader&nofooter}}
+==== POST Parameter ====
+URL REFUND: https://payment.girosolution.de/girocheckout/api/v2/transaction/refund
+^Name           ^Pflicht  ^Type        ^Beschreibung   ^
+|merchantId     |Ja       |Integer     |Händler-ID eines Kreditkarten Projekts |
+|projectId      |Ja       |Integer     |Projekt-ID eines Kreditkarten Projekts |
+|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, gemäß [[http://de.wikipedia.org/wiki/ISO_4217#Aktuell_g.C3.BCltige_W.C3.A4hrungen|ISO 4217]].\\ EUR = Euro |
+|reference      |Ja       |String      |GiroCheckout Transaktions-ID, für die eine Buchung oder Erstattung durchgeführt werden soll |
+|hash           |Ja       |String      |HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
+== Beispiel ==
+{{page>codesamples:ideal#refund.request&noheader&nofooter}}
+==== Antwort ====
+Die Antwort besteht aus einem JSON Objekt. Das Feld rc liefert einen Fehlercode zurück. Wird rc = 0 zurückgeliefert, wurde die Transaktion erfolgreich initialisiert. Sie bekommen als Antwort eine Transaktionsnummer und die redirectURL zum Kreditkartenformular zurück.
+=== Parameter ===
+^Name             ^Pflicht  ^Type        ^Beschreibung   ^
+|reference      |Ja       |String      | GiroCheckout Transaktions-ID |
+|merchantTxId   |Ja       |String      | Händler Transaktions-ID |
+|backendTxId    |Ja       |String      | Zahlungsabwickler Transaktions-ID |
+|amount         |Ja       |Integer     | bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent, Penny |
+|currency       |Ja       |String      | Währung |
+|resultPayment  |Ja       |Integer     | [[girocheckout:resultcodes#zahlungsausgang|Ergebnis der Transaktion]]|
+|hash           |Ja       |String      | HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]] |
+== Beispiel im Erfolgsfall ==
+{{page>codesamples:ideal#refund.response.true&noheader&nofooter}}
+== Beispiel im Fehlerfall ==
+{{page>codesamples:ideal#refund.response.false&noheader&nofooter}}

Girocheckout API

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge