Usando device fingerprint#

O que é um device fingerprint?#

O device fingerprint é usado para gerar um device_id que identifica exclusivamente o dispositivo de um cliente. Quando o cliente conclui uma compra, este device_id é associado ao pagamento. Tanto informações de pagamento quanto informações de dispositivo são utilizados por ferramentas antifraude para comparar o comportamento do cliente com comportamentos fraudulentos conhecidos, para detectar possíveis tentativas de fraude.

Por que devo usar?#

O device fingerprint é uma camada essencial de proteção que não afeta a experiência do cliente em seu site. Um fraudador inteligente pode facilmente disfarçar o endereço IP, e o device fingerprint pode identificar um fraudador usando uma lista de cartões de crédito em uma lista de perfis falsos.

Como eu uso isso?#

Você pode usar este JavaScript em sua página de checkout:

<script type="text/javascript" src="https://js.ebanxpay.com/ebanx-pay-libjs-latest.min.js"></script>
<script type="text/javascript">

    window.onload = function() {
        
        EBANX.config.setPublishableKey('1234');

        EBANX.config.setCountry("br");

        EBANX.config.setMode('test');

        EBANX.deviceFingerprint.setup(function(deviceId) {

            console.log("Device ID:", deviceId);
            // jQuery example:
            $('#my-hidden-input').val(deviceId);

        });

    };

</script>

Armazene o device_id retornado por nosso script e adicione este parâmetro à sua solicitação de pagamento quando for enviá-la para nós

curl -X POST 'https://staging.ebanx.com.br/ws/direct' \
-d 'request_body={
  "integration_key": "your_test_integration_key",
  "operation": "request",
  "payment": {
    "name": "José Silva",
    "email": "jose@example.com",
    "birth_date": "12/04/1979",
    "document": "853.513.468-93",
    "address": "Rua E",
    "street_number": "1040",
    "city": "Maracanaú",
    "state": "CE",
    "zipcode": "61919-230",
    "country": "br",
    "phone_number": "8522847035",
    "payment_type_code": "visa",
    "merchant_payment_code": "3d1e73b0bbe",
    "currency_code": "BRL",
    "instalments": 1,
    "device_id":"34c376b2767",
    "amount_total": 100,
    "creditcard": {
      "card_number": "4111111111111111",
      "card_name": "José Silva",
      "card_due_date": "12/2019",
      "card_cvv": "123"
    }
  }
}'