Skip to main content
Français Italiano Português

HiPay Enterprise – How to send the device fingerprint?

Please note: this article is only intended for the HiPay Enterprise Direct POST integration.

The device fingerprint identifies devices through information collected by a client run on an end user’s computer.

This client generates a black box that contains all the available device information.

Web applications obtain device information by sourcing dynamically generated JavaScript from HiPay Enterprise. The JavaScript determines what information is available and generates a black box from all available sources.

Black box content

A black box will typically:

  1. Range up to 4,000 bytes (the average length being just under 1,000
    bytes)
  2. Contain alphanumeric values and the following special characters: + / ; =
  3. Begin with 0200, 0400, 0500 or 0600

Generating black box content

To integrate the client, you must specify a hidden field that the JavaScript will populate.

This adds the black box as another field to be submitted along with the other details in the form.

What TO DO
 What NOT TO DO

1. You MUST INCLUDE a hidden form field with an “ioBB” ID that will be populated with the value.


2. You MUST CALL the HiPay Enterprise fingerprint JavaScript function to get the black box content: 

https://secure-gateway.hipay-tpp.com/gateway/toolbox/fingerprint

1. DO NOT CALL the HiPay Enterprise fingerprint JavaScript function BEFORE including the hidden “ioBB” form field.


2. DO NOT CACHE OR USE local copies of the JavaScript.

  • JavaScript is dynamically generated for each customer and caching of the script may cause unrelated devices to be identified as the same computer.
    The script also uses domain cookies to identify devices across subscribers.

Example of black box generation

<form name="test">
<!-- hidden field to store black box -->
  <input type="text" name="device_fingerprint" id="ioBB">
</form>
<!-- Include JavaScript fingerprint library -->
<script language="javascript" src="https://secure-gateway.hipay-tpp.com/gateway/toolbox/fingerprint">
</script>



Related articles