Integre la huella digital del dispositivo de DEUNA para motores de pagos y antifraude en su aplicación.

Debes generar tus propias huellas digitales para la mayoría de los motores.

DEUNA ofrece un script/SDK que crea todas las huellas digitales necesarias para evitar tareas manuales para cada script de huellas digitales.

Integra la huella digital del dispositivo de los motores antifraude y de pagos.

Web SDK < 1.6

Esta sección describe el comportamiento publicado actual. Úselo si ejecuta Web SDK por debajo de 1.6 o Cross-domain por debajo de 1.2.

1. Agrega el script de Mercado Pago#

Este script carga automáticamente todo lo necesario para crear la Huella del Dispositivo, la cual se envía al procesar con Mercado Pago o cualquiera que sea el motor antifraude o de pagos.

Mercado Pago y otros proveedores requieren esta información para asegurar la transacción.

window.DEUNA_CREDENTIALS = {  
  <provider name>: {},  
}

// example
window.DEUNA_CREDENTIALS = {  
  MERCADOPAGO: {},  
}

2. Select the suppliers (only needed for Web SDK < 1.6)#

Seleccione proveedores de motores antifraude.

La siguiente tabla contiene atributos para los motores admitidos por el widget:

3. Generar las huellas dactilares#

Genera huellas digitales dependiendo de tu tipo de integración.

3.1 Widget de pago DEUNA

Consulte el ejemplo del SDK web para initPaymentWidget.

Ampliar

3.2 API directa

Agregue el script de huellas digitales.

El script incluye un SDK DEUNA que es capaz de generar huellas digitales de cualquier proveedor bajo una única integración.

SDK Web

1. Siga los pasos para agregar e inicializar el SDK web.
2. Utilice el script para generar la huella digital.

<script>
    var script = document.createElement("script");
    script.id = "deuna-sdk";
    script.src = "https://cdn.deuna.io/web-sdk/v1.6/index.js";
    
    script.onload = async function () {  // ✅ Make function async
        // Initialize the SDK
        await DeunaSDK.initialize({
            publicApiKey: "<public api key>",
            env: "sandbox"  // "sandbox" or "production"
        });

        // Get the MasterDeviceId from DEUNA
        const fraudId = await DeunaSDK.generateFraudId({
            someProvider: {  // ✅ Replace with actual provider name
                // provider-specific data
            }
        });

        console.log("Fraud ID:", fraudId);
    };

    document.body.appendChild(script);
</script>

SDK iOS

1. Siga los pasos para agregar e inicializar el SDK DEUNA.
2. Usa la función generateFraudId para generar la huella digital.

deunaSDK.generateFraudId(
  params: [
    "RISKIFIED": [
      "storeDomain": "volaris.com"
    ]
  ]
) { fraudId in
   
}

SDK de Android

1. Siga los pasos para agregar e inicializar el SDK DEUNA.
2. Usa la función generateFraudId para generar la huella digital.

deunaSDK.generateFraudId(
  context = context,
  params = mapOf(
    "RISKIFIED" to mapOf(
      "storeDomain" to "deuna.com"
    )
  ),
  callback = { fraudId ->
  }
)

3. Obtén el valor de la huella digital del dispositivo y envíalo mediante Compra V2:

  {
    "payer_info": {
      "email": "john@doe.com",
      "card_holder_dni": "12345678"
    },
    "payment_source": {
      "method_type": "debit_card",
      "card_info": {
        "card_id": "<card id>"
      }
    },
    "order": {
      "order_id": "DEUNA-NOW-69553619",
       // ...
    },
    "anti_fraud_info": { // dentro de este objeto se manda el fingerprint
      "device": {
        // mandar el fingerprint como base64
        "id": "<device fingerprint generated by the DEUNA Fraud SDK>"
      }
    }
  }

3.3 Conector VTEX

Vea esta sección: /docs/vtex-device-fingerprin

SDK Web ≥ 1.6

Utilice esta sección si ejecuta Web SDK 1.6 o posterior.

En estas versiones, el equipo de DEUNA configura las credenciales antifraude. Esto cambia la integración de tres maneras:

• tu lo haces no agregar el script de Mercado Pago. el window.DEUNA_CREDENTIALS El objeto ya no es necesario.
• tu lo haces no utilice el paso de huella digital del widget de pago DEUNA. Ya no es necesario.
• El comerciante ya no envía fraudCredentials. DEUNA establece estos valores por usted.

Excepción SIGNIFICATIVA#

SIGNIFYD es el único proveedor que todavía necesita la opinión de los comerciantes en estas versiones. El comerciante debe pasar el email desde la sesión del usuario en generateFraudId.

Guión de inicialización#

Agregue e inicialice el SDK. En estas versiones llamas generateFraudId sin credenciales proporcionadas por el comerciante:

<script>
    var script = document.createElement("script");
    script.id = "deuna-sdk";
    script.src = "https://cdn.deuna.io/web-sdk/v1.6/index.js";

    script.onload = async function () {  // ✅ Make function async
        await DeunaSDK.initialize({
            publicApiKey: "<public api key>",
            env: "sandbox"  // "sandbox" or "production"
        });

        const fraudId = await DeunaSDK.generateFraudId();
        console.log("Fraud ID:", fraudId);
    };

    document.body.appendChild(script);
</script>

Fragmento SIGNIFYD (≥ 1,6)#

Para SIGNIFYD, pase el email desde la sesión del usuario:

const fraudId = await DeunaSDK.generateFraudId({
    SIGNIFYD: { email: "<email from user session>" }
});