This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
en:girocheckout:bluecode:start [2019/06/11 18:39] michaelheumann |
en:girocheckout:bluecode:start [2023/05/08 02:05] (current) michaelheumann |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | You may find further information on the payment method "Blue Code" here: https:// | + | You may find further information on the payment method "Bluecode" here: https:// |
===== Testdata ===== | ===== Testdata ===== | ||
Line 18: | Line 18: | ||
</ | </ | ||
- | ===== Initializing a Blue Code payment ===== | + | ===== Initializing a Bluecode |
After a successful initialization a reference number and a redirect link is transmitted to the merchant. The transmitted link leads to the payment form, to which the customer must be redirected. This may be done via an HTTP redirect hreader, an HTML page with a meta tag or Javascript. | After a successful initialization a reference number and a redirect link is transmitted to the merchant. The transmitted link leads to the payment form, to which the customer must be redirected. This may be done via an HTTP redirect hreader, an HTML page with a meta tag or Javascript. | ||
Line 32: | Line 32: | ||
participant " | participant " | ||
participant " | participant " | ||
- | participant "Blue Code" as bc | + | participant "Bluecode" as bc |
autonumber | autonumber | ||
Line 54: | Line 54: | ||
</ | </ | ||
- | - Customer selects payment method | + | - Customer selects payment method |
- | - Shop initializes | + | - Shop initializes |
- Shop receives response about transaction outcome (transaction ends on error) and sends redirect URL to customer browser | - Shop receives response about transaction outcome (transaction ends on error) and sends redirect URL to customer browser | ||
- | - Customer browser forwards to the Blue Code payment page, where a QR code is displayed (in Desktop variant) | + | - Customer browser forwards to the Bluecode |
- | - Customer scans QR code with his smartphone (Blue Code App) (in Desktop variant) | + | - Customer scans QR code with his smartphone (Bluecode |
- | - Blue Code sends message to customer smartphone and waits for confirmation | + | - Bluecode |
- Customer authorizes the transaction on his smartphone | - Customer authorizes the transaction on his smartphone | ||
- | - Blue Code processes the transaction | + | - Bluecode |
- Customer clicks "Back to shop" ([[en: | - Customer clicks "Back to shop" ([[en: | ||
- | - Blue Code transmits result to GiroCheckout | + | - Bluecode |
- GiroCheckout notifies shop about transaction outcome ([[en: | - GiroCheckout notifies shop about transaction outcome ([[en: | ||
- Shop processes transaction outcome | - Shop processes transaction outcome | ||
Line 83: | Line 83: | ||
^Name | ^Name | ||
- | |merchantId | + | |merchantId |
- | |projectId | + | |projectId |
- | |merchantTxId | + | |merchantTxId |
|amount | |amount | ||
|currency | |currency | ||
|purpose | |purpose | ||
- | |urlRedirect | + | |urlRedirect |
- | |urlNotify | + | |urlNotify |
- | |hash | + | |kassenzeichen |
+ | |hash | ||
== Example == | == Example == | ||
Line 97: | Line 98: | ||
==== Response ==== | ==== Response ==== | ||
- | The response is a JSON object. The field rc returns an error code. If rc=0 is returned, the transaction was initialized successfully. As a response, you receive a transaction number and the redirectURL to the Blue Code payment page. | + | The response is a JSON object. The field rc returns an error code. If rc=0 is returned, the transaction was initialized successfully. As a response, you receive a transaction number and the redirectURL to the Bluecode |
=== Parameters === | === Parameters === | ||
^Name | ^Name | ||
|rc | |rc | ||
- | |msg |Yes | + | |msg |Yes |
- | |reference | + | |reference |
- | |redirect | + | |redirect |
^HEADER Parameters^^^^ | ^HEADER Parameters^^^^ | ||
- | |hash | + | |hash |
== Example in case of success == | == Example in case of success == | ||
Line 113: | Line 114: | ||
== Example in case of failure == | == Example in case of failure == | ||
{{page> | {{page> | ||
- | |||
==== Notification about payment result ==== | ==== Notification about payment result ==== | ||
Line 128: | Line 128: | ||
=== GET Parameters === | === GET Parameters === | ||
^Name | ^Name | ||
- | |gcReference | + | |gcReference |
- | |gcMerchantTxId | + | |gcMerchantTxId |
- | |gcBackendTxId | + | |gcBackendTxId |
|gcAmount | |gcAmount | ||
- | |gcCurrency | + | |gcCurrency |
|gcResultPayment | |gcResultPayment | ||
- | |gcHash | + | |gcHash |
=== Response === | === Response === | ||
Line 154: | Line 154: | ||
== GET Parameters == | == GET Parameters == | ||
^Name | ^Name | ||
- | |gcReference | + | |gcReference |
- | |gcMerchantTxId | + | |gcMerchantTxId |
- | |gcBackendTxId | + | |gcBackendTxId |
|gcAmount | |gcAmount | ||
- | |gcCurrency | + | |gcCurrency |
|gcResultPayment | |gcResultPayment | ||
- | |gcHash | + | |gcHash |
Line 174: | Line 174: | ||
|merchantId | |merchantId | ||
|projectId | |projectId | ||
- | |merchantTxId | + | |merchantTxId |
|amount | |amount | ||
|currency | |currency | ||
- | |reference | + | |reference |
- | |purpose | + | |purpose |
- | |hash | + | |hash |
== Example == | == Example == | ||
Line 190: | Line 190: | ||
^Name | ^Name | ||
|rc | |rc | ||
- | |msg |yes | + | |msg |yes |
- | |reference | + | |reference |
- | |merchantTxId | + | |merchantTxId |
- | |backendTxId | + | |backendTxId |
|amount | |amount | ||
- | |currency | + | |currency |
|resultPayment | |resultPayment | ||
^HEADER parameter^^^^ | ^HEADER parameter^^^^ | ||
- | |hash | + | |hash |
== Example in case of success == | == Example in case of success == |