Menu

User Tools

Create PDF

Site Tools


Differences

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

Go

Link to this comparison view

payment_methods:invoice:wirecard [2017-07-12 13:54]
lkn [Required request parameters]
payment_methods:invoice:wirecard [2020-10-28 07:31] (current)
Line 21: Line 21:
  
 For payment method ''Invoice by Wirecard'' the otherwise optional request parameters for **consumer billing data** and **shopping basket data are required**. For further information on these parameters go to [[:request_parameters#Consumer_billing_data|Consumer billing data]] and [[:request_parameters#Shopping_basket_data|Shopping basket data]]. For payment method ''Invoice by Wirecard'' the otherwise optional request parameters for **consumer billing data** and **shopping basket data are required**. For further information on these parameters go to [[:request_parameters#Consumer_billing_data|Consumer billing data]] and [[:request_parameters#Shopping_basket_data|Shopping basket data]].
 +
 +Also, the parameter **consumerDeviceId** is required for payment method ''Invoice by Wirecard''.
  
 Please note the **length restrictions** that apply for this payment method and the following **shopping basket parameters**. Please note the **length restrictions** that apply for this payment method and the following **shopping basket parameters**.
Line 28: Line 30:
 | basketItem(n)ArticleNumber | Required if used. | Alphanumeric with special characters and with a variable length of up to 254 characters. | Unique ID of article n in shopping basket. |  | basketItem(n)ArticleNumber | Required if used. | Alphanumeric with special characters and with a variable length of up to 254 characters. | Unique ID of article n in shopping basket. | 
 | basketItem(n)Description | Required if used. | Alphanumeric with special characters and with a variable length of up to 50 characters. | Product description of article n in shopping basket. |  | basketItem(n)Description | Required if used. | Alphanumeric with special characters and with a variable length of up to 50 characters. | Product description of article n in shopping basket. | 
 +
 +=== Device fingerprinting ===
 +The required request parameter ''consumerDeviceId'' is a security parameter used in terms of a Device Fingerprinting (DFP) which is a method of fraud protection and allows to identify technical devices used by the consumer.
  
 ^  Security parameter  ^^^^ ^  Security parameter  ^^^^
 ^ Parameter  ^ Within fingerprint ^ Data type  ^ Short description  ^ ^ Parameter  ^ Within fingerprint ^ Data type  ^ Short description  ^
-| consumerDeviceId        | Optional | Alphanumeric with special characters and a variable length of up to 255 characters. | Unique token, e.gencrypted combination of customerId and timestamp which serves as a method of fraud protection|+| consumerDeviceId  | Optional | Alphanumeric with special characters and a variable length of up to 255 characters. | Unique token which serves as a method of fraud protection
 + 
 +In order to use the parameter ''consumerDeviceId'' you first need to generate a **unique token** and **run a JavaScript** as described in the following sections. 
 + 
 +The request parameter ''consumerDeviceId'' is transmitted to Wirecard at the **initiation** of Wirecard Checkout Page or Wirecard Checkout Seamless front-end. The value of the parameter needs to be the **unique token**.  
 + 
 +The unique token, identifying your consumer during the process of ordering, is thus transmitted via JavaScript **and** via the request parameter ''consumerDeviceId''. 
 + 
 +**Generating a unique token** 
 + 
 +To ensure that the token is really unique, it is suggested to use a hashed combination of ''customerId'' and timestamp, using for instance MD5 as hash function. 
 + 
 +<code java> 
 + 
 +$timestamp = microtime(); 
 +$customerId = "YOUR-CUSTOMER-ID"; 
 +$consumerDeviceId = md5($customerId . "_" . $timestamp); 
 +</code> 
 + 
 +''"YOUR-CUSTOMER-ID"'' refers to your unique [[:request_parameters#customerid|customer ID]] which is used to identify your online shop with the Wirecard Checkout Server. 
 + 
 +**Running JavaScript** 
 + 
 +It is recommended to output the JavaScript code as early as possible, i.e. when the consumer has entered the checkout process in the online shop or when first item is put into the cart. 
 + 
 +Please ensure that this script is executed one-time only per session (per customer + checkout + device).  
 + 
 +JavaScript (example): 
 + 
 +<code java> 
 +<script language="JavaScript"> 
 +    var di = {t:'<?php echo $consumerDeviceId ?>',v:'WDWL',l:'Checkout'}; 
 +</script> 
 +<script type="text/javascript" src="//d.ratepay.com/<?php echo $consumerDeviceId?>/di.js"></script> 
 +<noscript> 
 +    <link rel="stylesheet" type="text/css" href="//d.ratepay.com/di.css?t=<?php echo $consumerDeviceId ?>&v=WDWL&l=Checkout"> 
 +</noscript> 
 +<object type="application/x-shockwave-flash" data="//d.ratepay.com/WDWL/c.swf" width="0" height="0"> 
 +    <param name="movie" value="//d.ratepay.com/WDWL/c.swf" /> 
 +    <param name="flashvars" value="t=<?php echo $consumerDeviceId ?>&v=WDWL"/> 
 +    <param name="AllowScriptAccess" value="always"/> 
 +</object>  
 +</code> 
 ===== Optional request parameters ===== ===== Optional request parameters =====
  

This website uses cookies to deliver the best service to you. By continuing to browse the site, you are agreeing to our use of cookies.