Device Fingerprint

Integration

In order to integrate Wirecard’s Device Fingerprint (FPS) with your website, you need to insert Profiling Tags on web pages where you will profile consumer’s devices. You can either insert the tags directly into your website, or use our iframe service to embed the tags within an iframe.

Profiling Tags are placed on HTML pages served by your web application, and allow Wirecard to collect device information from the consumer’s browser. You need to identify pages in your web application in which to place the tags that ensures that their devices are profiled before submitting a transaction.

HTML Sample for Profiling Tags
Profiling Tags
<script type="text/javascript" src="https://h.wirecard.com/fp/tags.js?org_id=6xxznhva&session_id=session_id"></script>
<noscript>
   <iframe style="width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;" src="https://h.wirecard.com/tags?org_id=6xxznhva&session_id=session_id"></iframe>
</noscript>

The org_id is fix for all merchants: value is 6xxznhva.

The session_id is a temporary identifier that is unique to the consumer’s session.

  • It can be up to 128 bytes long and must only consist of the following characters: upper and lowercase English letters, digits, underscore or hyphen ([a-zA-Z0-9_-]).

  • The format should be: <merchant_id>_<random_string> where

    • <merchant_id> is a unique merchant identifier (You can use the Merchant Account ID or any other unique ID defined in the Wirecard system).

    • <random_string> is a generated by the merchant

As a final optional consideration you may want to remove the reference to http://h.wirecard.com and set up web server redirection instead to avoid placing a third-party domain name inside your HTML.

For this you will need to set up a DNS entry for your sub-domain that redirects to http://h.wirecard.com and give your certificate to Wirecard to be placed on the device identification server.

Transmit to Wirecard Payment Gateway

To use the Device Fingerprint the session_id (generated as above) has to be transmitted with the payment transaction to the Wirecard Payment Gateway.

The Wirecard Payment Gateway provides the field device/fingerprint for this process. For details see the REST API Fields list.

Custom URL: