Intégrez l'empreinte digitale de l'appareil de DEUNA pour les moteurs antifraude et de paiement dans votre application.

Vous devez générer vos propres empreintes digitales pour la plupart des moteurs.

DEUNA offre un script / SDK qui crée toutes les empreintes digitales nécessaires pour éviter les tâches manuelles pour chaque script d'empreintes digitales.

Intégre l'empreinte digitale du dispositif des moteurs antifraude et de paiement.

Web SDK < 1.6

Cette section décrit le comportement actuel, publié. Utilisez-le si vous exécutez Web SDK en dessous de 1.6 ou Cross-domaine en dessous de 1.2.

1. Ajouter le script Mercado Pago#

Ce script charge automatiquement tout ce qui est nécessaire pour créer l'empreinte de doigt de l'appareil, qui est envoyé lors du traitement avec Mercado Pago ou quel que soit le moteur antifraude ou de paiement.

Mercado Pago et d'autres fournisseurs exigent ces informations pour sécuriser la transaction.

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

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

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

Sélectionnez les fournisseurs de moteurs antifraude.

Le tableau suivant contient les attributs des moteurs supportés par le widget:

3. Générer les empreintes digitales#

Générer des empreintes digitales selon votre type d'intégration.

3.1 DÉUNA Widget de paiement

Voir l'exemple de SDK Web pour initPaymentWidget.

Agrandir

3.2 API directe

Ajoutez le script d'empreintes digitales.

Le script comprend un SDK DEUNA capable de générer des empreintes digitales de n'importe quel fournisseur sous une seule intégration.

SDK Web

1. Suivez les étapes pour ajouter et initialiser le SDK Web.
2. Utilisez le script pour générer l'empreinte digitale.

<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. Suivez les étapes pour ajouter et initialiser le SDK DEUNA.
2. Utiliser la fonction generateFraudId pour générer l'empreinte digitale.

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

SDK Android

1. Suivez les étapes pour ajouter et initialiser le SDK DEUNA.
2. Utiliser la fonction generateFraudId pour générer l'empreinte digitale.

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

3. Récupérez la valeur de l’empreinte de l’appareil et envoyez-la via Acheter la 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 Connecteur VTEX

Voir cette section: /docs/vtex-device-fingerprin

SDK Web ≥ 1.6

Utilisez cette section si vous exécutez Web SDK 1.6 ou plus tard.

Dans ces versions, l'équipe DEUNA configure les identifiants antifraude. Cela change l'intégration de trois façons :

• Vous le savez. pas ajouter le script Mercado Pago. Les window.DEUNA_CREDENTIALS objet n'est plus nécessaire.
• Vous le savez. pas utiliser l'étape d'empreintes digitales du widget DEUNA Payment. Ce n'est plus nécessaire.
• Le marchand n'envoie plus fraudCredentials. DEUNA vous fixe ces valeurs.

Exception SIGNIFIÉ#

SIGNIHYD est le seul fournisseur qui a encore besoin d'une entrée dans ces versions. Le marchand doit passer le email de la session utilisateur en generateFraudId.

script d'initialisation#

Ajouter et initialiser le SDK. Dans ces versions, vous appelez generateFraudId sans justificatifs de commerce:

<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>

Extrait de SIGNIHYD (≥ 1,6)#

Pour SIGNIFIYD, passez le email lors de la session utilisateur:

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