User Tools

Site Tools


en:girocheckout:bluecode:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

en:girocheckout:bluecode:start [2019/06/11 18:39]
michaelheumann
en:girocheckout:bluecode:start [2019/06/13 19:21] (current)
michaelheumann
Line 1: Line 1:
-====== ​Blue Code ======+====== ​Bluecode ​======
  
-You may find further information on the payment method "Blue Code" here: https://​www.bluecode.com/​.+You may find further information on the payment method "Bluecode" here: https://​www.bluecode.com/​.
  
 ===== Testdata ===== ===== Testdata =====
Line 18: Line 18:
 </​uml>​ </​uml>​
  
-===== Initializing a Blue Code payment =====+===== Initializing a Bluecode ​payment =====
 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 "​Shop"​ as shop participant "​Shop"​ as shop
 participant "​GiroCheckout"​ as girocheckout participant "​GiroCheckout"​ as girocheckout
-participant "Blue Code" as bc+participant "Bluecode" as bc
  
 autonumber autonumber
Line 54: Line 54:
 </​uml>​ </​uml>​
  
-  - Customer selects payment method ​Blue Code +  - Customer selects payment method ​Bluecode 
-  - Shop initializes ​Blue Code transaction ([[en:​girocheckout:​bluecode:​start#​initializing_a_blue_code_payment|Initialization]])+  - Shop initializes ​Bluecode ​transaction ([[en:​girocheckout:​bluecode:​start#​initializing_a_bluecode_payment|Initialization]])
   - 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 ​payment page, where a QR code is displayed (in Desktop variant) 
-  - Customer scans QR code with his smartphone (Blue Code App) (in Desktop variant) +  - Customer scans QR code with his smartphone (Bluecode ​App) (in Desktop variant) 
-  - Blue Code sends message to customer smartphone and waits for confirmation+  - Bluecode ​sends message to customer smartphone and waits for confirmation
   - Customer authorizes the transaction on his smartphone   - Customer authorizes the transaction on his smartphone
-  - Blue Code processes the transaction+  - Bluecode ​processes the transaction
   - Customer clicks "Back to shop" ([[en:​girocheckout:​bluecode:​start#​redirecting_the_customer_to_the_merchant|Redirect]])   - Customer clicks "Back to shop" ([[en:​girocheckout:​bluecode:​start#​redirecting_the_customer_to_the_merchant|Redirect]])
-  - Blue Code transmits result to GiroCheckout+  - Bluecode ​transmits result to GiroCheckout
   - GiroCheckout notifies shop about transaction outcome ([[en:​girocheckout:​bluecode:​start#​notification_about_payment_result|Notification]])   - GiroCheckout notifies shop about transaction outcome ([[en:​girocheckout:​bluecode:​start#​notification_about_payment_result|Notification]])
   - Shop processes transaction outcome   - Shop processes transaction outcome
Line 83: Line 83:
  
 ^Name           ​^Mandatory ​ ^Type        ^Description ​  ^ ^Name           ​^Mandatory ​ ^Type        ^Description ​  ^
-|merchantId ​    ​|Yes ​      ​|Integer ​    ​|Merchant ID of a Blue Code project | +|merchantId ​    ​|Yes ​      ​|Integer ​    ​|Merchant ID of a Bluecode ​project | 
-|projectId ​     |Yes       ​|Integer ​    ​|Project ID of a Blue Code project |+|projectId ​     |Yes       ​|Integer ​    ​|Project ID of a Bluecode ​project |
 |merchantTxId ​  ​|Yes ​      ​|String(255) |Unique merchant transaction ID | |merchantTxId ​  ​|Yes ​      ​|String(255) |Unique merchant transaction ID |
 |amount ​        ​|Yes ​      ​|Integer ​    |If a decimal currency is used, the amount has to be in the smallest unit of value, eg. Cent, Penny | |amount ​        ​|Yes ​      ​|Integer ​    |If a decimal currency is used, the amount has to be in the smallest unit of value, eg. Cent, Penny |
Line 97: Line 97:
  
 ==== 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 ​payment page. 
  
 === Parameters === === Parameters ===
Line 104: Line 104:
 |msg            |Yes       ​|String ​   |Additional information in case of error | |msg            |Yes       ​|String ​   |Additional information in case of error |
 |reference ​     |Optional |String ​   |Unique GiroCheckout transaction ID | |reference ​     |Optional |String ​   |Unique GiroCheckout transaction ID |
-|redirect ​      ​|Optional |String ​   |Redirect URL that leads the customer to the Blue Code payment page|+|redirect ​      ​|Optional |String ​   |Redirect URL that leads the customer to the Bluecode ​payment page|
 ^HEADER Parameters^^^^ ^HEADER Parameters^^^^
 |hash           ​|Yes ​      ​|String ​   |HMAC MD5 hash over the complete JSON string. (see [[en:​girocheckout:​general:​start#​api_call_reply_to_the_merchant|api call reply]]) | |hash           ​|Yes ​      ​|String ​   |HMAC MD5 hash over the complete JSON string. (see [[en:​girocheckout:​general:​start#​api_call_reply_to_the_merchant|api call reply]]) |
en/girocheckout/bluecode/start.txt · Last modified: 2019/06/13 19:21 by michaelheumann