Passa al contenuto principale
In questa pagina

Integrare le impronte del dispositivo di DEUNA per i motori anti-frode e di pagamento nella tua applicazione.

Devi generare le tue impronte digitali per la maggior parte dei motori.

DEUNA offre uno script / SDK che crea tutte le impronte necessarie per evitare le attività manuali per ogni script di impronte digitali.

Integra l'impronta digitale del dispositivo dei motori anti-frode e di pagamento.

Web SDK < 1.6

Questa sezione descrive il comportamento attuale e pubblicato. Utilizzare se si esegue Web SDK sotto 1.6 o Cross-domain sotto 1.2.

1. Aggiungere lo script di Mercado Pago#

Questo script carica automaticamente tutto il necessario per creare il Device Fingerprint, che viene inviato quando si elabora con Mercado Pago o qualsiasi sia il motore anti-frode o di pagamento.

Mercado Pago e altri fornitori richiedono che queste informazioni siano protette.

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

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

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

Selezionare fornitori di motori anti-fraud.

La seguente tabella contiene attributi per i motori supportati dal widget:

Motore

Attributi

Esempio

BAZ

orgId, mercante

BAZ: { orgId: '', merchantId: '' }

CLEARSALE / CLEARSALE-BRASIL

ClientId

CLEARSALE: { clientId: '' } CLEARSALE-BRASIL: { clientId: '' }

CYBERSOURCE

orgId, mercante

CYBERSOURCE: { orgId: '', merchantId: '' }

MERCADOPAGO

Non richiede parametri a livello commerciante id

MERCADOPAGO: {}

SIFT

AccountId, restoApiKey

SIFT: { accountId: '', restApiKey: '' }

SIGNIFYD

Account e Email: Richiesto per tutte le implementazioni.

Session ID è solo richiesto se il vostro sistema mercantile genera la sessioneId prima di DEUNA. Questo di solito si applica quando si invia eventi direttamente a Signifyd e hanno bisogno che gli eventi inviati da DEUNA siano abbinati alla stessa sessione di Signifyd.

In questo caso, è necessario inviare la stessa sessioneId a DEUNA in modo che tutti gli eventi possono essere correttamente collegati in Signifyd.

Se non si genera un sessionId o non si invia eventi direttamente a Signifyd, non è necessario generare o inviare questo campo a DEUNA.s

Org ID è richiesto per l'implementazione di applicazioni native. Questa differenza di requisito da Web viene da Signifyd e NON da DEUNA. La ragione per cui si parla è: L'orgId è necessario per il SDK mobile perché, a differenza del web, dove lo script TMX associa automaticamente la sessione con l'account Signify attraverso il ceppet JavaScript, il SDK mobile deve essere configurato per collegare correttamente l'impronta digitale del dispositivo al relativo account.

SIGNIFYD: {account: '', email: '', sessionId: '', orgId: '<needed for native apps>}

STRIPE

API_KEY

STRIPE: { apiKey: '' }

RISKIFIED

storeDomain

RISKIFIED: { storeDomain: '' }

ACCERTIFY

src, collettoreHostSrc, sid, id, dvc

ACCERTIFY: { src: '', collectorHostSrc: '', sid: '', id: '', dvc: '' }

KOUNT

clientId, ambiente, isSinglePageApp

KOUNT: { clientId: '', environment: '', isSinglePageApp: ''},

KOIN

orgId

KOIN: { orgId: ''}

PAYU

Non richiede parametri a livello commerciante id

PAYU: {}

3. Generare le impronte digitali#

Genera le impronte digitali a seconda del tipo di integrazione.

3.1 DEUNA widget di pagamento

Vedere l'esempio di Web SDK per initPaymentWidget.


3.2 API diretta

Aggiungi lo script delle impronte.

Lo script include un SDK DEUNA che è in grado di generare impronte digitali da qualsiasi provider sotto una singola integrazione.

SDK Web

  1. Seguire i passaggi per aggiungere e inizializzare il Web SDK.
  2. Usa lo script per generare l'impronta digitale.
html
<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. Seguire i passaggi per aggiungere e inizializzare il DEUNA SDK.
  2. Utilizzare la funzione generateFraudId per generare l'impronta digitale.
Swift
deunaSDK.generateFraudId(
  params: [
    "RISKIFIED": [
      "storeDomain": "volaris.com"
    ]
  ]
) { fraudId in
   
}

SDK Android

  1. Seguire i passaggi per aggiungere e inizializzare il DEUNA SDK.
  2. Utilizzare la funzione generateFraudId per generare l'impronta digitale.
Kotlin
deunaSDK.generateFraudId(
  context = context,
  params = mapOf(
    "RISKIFIED" to mapOf(
      "storeDomain" to "deuna.com"
    )
  ),
  callback = { fraudId ->
  }
)
  1. Ottieni il valore dell’impronta digitale del dispositivo e invialo tramite Acquisto V2:
JSON
  {
    "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 Connettore VTEX

Vedi questa sezione: /docs/vtex-device-fingerprin

Web SDK ≥ 1.6

Utilizzare questa sezione se si esegue Web SDK 1.6 o versioni successive.

In queste versioni, il team DEUNA configura le credenziali anti-fraud. Questo cambia l'integrazione in tre modi:

  • Tu sei non non non lo so aggiungere lo script Mercado Pago. Il window.DEUNA_CREDENTIALS oggetto non è più richiesto.
  • Tu sei non non non lo so utilizzare il passo DEUNA Payment widget impronta digitale. Non è più necessario.
  • Il mercante non manda più fraudCredentials. DEUNA imposta questi valori per voi.

Eccezione di SIGNIFICAZIONE#

SIGNIFYD è l'unico fornitore che ha ancora bisogno di input mercantili in queste versioni. Il mercante deve passare il email dalla sessione utente in generateFraudId.

script di inizializzazione#

Aggiungere e inizializzare il SDK. In queste versioni si chiama generateFraudId senza credenziali di rifornimento del commerciante:

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

Snippet SIGNIFYD (≥ 1.6)#

Per SIGNIFYD, passare il email dalla sessione utente:

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