Premium Fraud Management Tools

Device Data Collectionanchor

Collecting device dataanchor

It is recommended that all customer-initiated transactions include device data. Device data increases the accuracy of our available Premium Fraud Management Tools in determining when a transaction is fraudulent.

Integrationanchor

If you are using script tags to load files, make sure to include:

  1. HTML
<script src="https://js.braintreegateway.com/web/3.87.0/js/client.min.js"></script>
<script src="https://js.braintreegateway.com/web/3.87.0/js/data-collector.min.js"></script>

To collect device data, create a client and a dataCollector instance. You can use the same client as you are using for other components, such as hostedFields or paypal.

  1. Callbacks
  2. Promises
braintree.client.create({
  authorization: 'CLIENT_AUTHORIZATION'
}, function (err, clientInstance) {
  // Creation of any other components...

  braintree.dataCollector.create({
    client: clientInstance
  }, function (err, dataCollectorInstance) {
    if (err) {
      // Handle error in creation of data collector
      return;
    }
    // At this point, you should access the dataCollectorInstance.deviceData value and provide it
    // to your server, e.g. by injecting it into your form as a hidden input.
    var deviceData = dataCollectorInstance.deviceData;
  });
});

Using Device Dataanchor

Include the device data string in the Transaction: Sale call on your server. Be careful to pass the string exactly as it is returned by the client side data collector component. Any modifications (such as escaping characters or encoding the string in a different format than UTF-8) will invalidate the payload. If our Premium Fraud Management Tools detect a high probability that the transaction is fraudulent it will be rejected.

Contact us for more information.

See also