Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
girocheckout:bluecode:start [2019/06/11 18:39] michaelheumann |
girocheckout:bluecode:start [2023/05/08 02:01] (aktuell) michaelheumann |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ====== | + | ====== |
- | Informationen zu Blue Code sind unter https:// | + | Informationen zu Bluecode |
===== Testdaten ===== | ===== Testdaten ===== | ||
Zeile 18: | Zeile 18: | ||
</ | </ | ||
- | ===== Initialisierung einer Blue Code Zahlung ===== | + | ===== Initialisierung einer Bluecode |
Durch eine erfolgreiche Initialisierung wird eine Referenznummer erstellt sowie ein Weiterleitungslink (redirect) an den Händler übermittelt. Der übermittelte Link führt zum Bezahlformular. Der Kunde muss an diese URL weitergeleitet werden. Dies kann durch einen HTTP-Redirect-Header, | Durch eine erfolgreiche Initialisierung wird eine Referenznummer erstellt sowie ein Weiterleitungslink (redirect) an den Händler übermittelt. Der übermittelte Link führt zum Bezahlformular. Der Kunde muss an diese URL weitergeleitet werden. Dies kann durch einen HTTP-Redirect-Header, | ||
Zeile 32: | Zeile 32: | ||
participant " | participant " | ||
participant " | participant " | ||
- | participant "Blue Code" as bc | + | participant "Bluecode" as bc |
autonumber | autonumber | ||
Zeile 54: | Zeile 54: | ||
</ | </ | ||
- | - Käufer wählt Zahlart | + | - Käufer wählt Zahlart |
- | - Shop initiiert | + | - Shop initiiert |
- Shop bekommt Rückmeldung über Initialisierungsausgang (bei Fehler ist Transaktion beendet) und sendet Redirect URL an Kundenbrowser | - Shop bekommt Rückmeldung über Initialisierungsausgang (bei Fehler ist Transaktion beendet) und sendet Redirect URL an Kundenbrowser | ||
- | - Kundenbrowser leitet zur Bezahlseite für Blue Code weiter, wo ein QR-Code angezeigt wird | + | - Kundenbrowser leitet zur Bezahlseite für Bluecode |
- | - Kunde scannt mit dem Smartphone (Blue Code App) QR-Code ab | + | - Kunde scannt mit dem Smartphone (Bluecode |
- | - Blue Code sendet Mittelung an Smartphone des Kunden und wartet auf Bestätigung | + | - Bluecode |
- Kunde autorisiert auf dem Smartphone die Transaktion | - Kunde autorisiert auf dem Smartphone die Transaktion | ||
- | - Blue Code führt Transaktion durch | + | - Bluecode |
- Kunde klickt " | - Kunde klickt " | ||
- | - Blue Code übermittelt Ergebnis an GiroCheckout | + | - Bluecode |
- GiroCheckout benachrichtigt Shop über Transaktionsausgang ([[girocheckout: | - GiroCheckout benachrichtigt Shop über Transaktionsausgang ([[girocheckout: | ||
- Shop verarbeitet Transaktionsausgang | - Shop verarbeitet Transaktionsausgang | ||
Zeile 83: | Zeile 83: | ||
^Name | ^Name | ||
- | |merchantId | + | |merchantId |
- | |projectId | + | |projectId |
- | |merchantTxId | + | |merchantTxId |
|amount | |amount | ||
|currency | |currency | ||
|purpose | |purpose | ||
- | |urlRedirect | + | |urlRedirect |
- | |urlNotify | + | |urlNotify |
- | |hash | + | |kassenzeichen |
+ | |hash | ||
== Beispiel == | == Beispiel == | ||
Zeile 97: | Zeile 98: | ||
==== Antwort ==== | ==== Antwort ==== | ||
- | Die Antwort besteht aus einem JSON Objekt. Das Feld rc liefert einen Fehlercode zurück. Wird rc = 0 zurückgeliefert, | + | Die Antwort besteht aus einem JSON Objekt. Das Feld rc liefert einen Fehlercode zurück. Wird rc = 0 zurückgeliefert, |
=== Parameter === | === Parameter === | ||
^Name | ^Name | ||
|rc | |rc | ||
- | |msg |Ja | + | |msg |Ja |
- | |reference | + | |reference |
- | |redirect | + | |redirect |
^HEADER Parameter^^^^ | ^HEADER Parameter^^^^ | ||
- | |hash | + | |hash |
== Beispiel im Erfolgsfall == | == Beispiel im Erfolgsfall == | ||
Zeile 128: | Zeile 129: | ||
=== GET Parameter === | === GET Parameter === | ||
^Name | ^Name | ||
- | |gcReference | + | |gcReference |
- | |gcMerchantTxId | + | |gcMerchantTxId |
- | |gcBackendTxId | + | |gcBackendTxId |
|gcAmount | |gcAmount | ||
- | |gcCurrency | + | |gcCurrency |
|gcResultPayment | |gcResultPayment | ||
- | |gcHash | + | |gcHash |
=== Antwort === | === Antwort === | ||
Zeile 154: | Zeile 155: | ||
== GET Parameter == | == GET Parameter == | ||
^Name | ^Name | ||
- | |gcReference | + | |gcReference |
- | |gcMerchantTxId | + | |gcMerchantTxId |
- | |gcBackendTxId | + | |gcBackendTxId |
|gcAmount | |gcAmount | ||
- | |gcCurrency | + | |gcCurrency |
|gcResultPayment | |gcResultPayment | ||
- | |gcHash | + | |gcHash |
Zeile 176: | Zeile 177: | ||
|merchantId | |merchantId | ||
|projectId | |projectId | ||
- | |merchantTxId | + | |merchantTxId |
|amount | |amount | ||
|currency | |currency | ||
|purpose | |purpose | ||
- | |reference | + | |reference |
- | |hash | + | |hash |
== Beispiel == | == Beispiel == | ||
Zeile 192: | Zeile 193: | ||
^Name | ^Name | ||
|rc | |rc | ||
- | |msg |Ja | + | |msg |Ja |
- | |reference | + | |reference |
- | |referenceParent | + | |referenceParent |
- | |merchantTxId | + | |merchantTxId |
- | |backendTxId | + | |backendTxId |
|amount | |amount | ||
- | |currency | + | |currency |
|resultPayment | |resultPayment | ||
- | |hash | + | |hash |
== Beispiel im Erfolgsfall == | == Beispiel im Erfolgsfall == |