Impronte di dispositivo
Integrare le impronte del dispositivo di DEUNA per i motori anti-frode e di pagamento, con il comportamento specifico della versione per Web SDK / Cross-domain.
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.
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 |
|
CLEARSALE / CLEARSALE-BRASIL | ClientId |
|
CYBERSOURCE | orgId, mercante |
|
MERCADOPAGO | Non richiede parametri a livello commerciante id |
|
SIFT | AccountId, restoApiKey |
|
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. |
|
STRIPE | API_KEY |
|
RISKIFIED | storeDomain |
|
ACCERTIFY | src, collettoreHostSrc, sid, id, dvc |
|
KOUNT | clientId, ambiente, isSinglePageApp |
|
KOIN | orgId |
|
PAYU | Non richiede parametri a livello commerciante id |
|
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
- Seguire i passaggi per aggiungere e inizializzare il Web SDK.
- Usa lo script per generare l'impronta 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
- Seguire i passaggi per aggiungere e inizializzare il DEUNA SDK.
- Utilizzare la funzione
generateFraudIdper generare l'impronta digitale.
deunaSDK.generateFraudId(
params: [
"RISKIFIED": [
"storeDomain": "volaris.com"
]
]
) { fraudId in
}SDK Android
- Seguire i passaggi per aggiungere e inizializzare il DEUNA SDK.
- Utilizzare la funzione
generateFraudIdper generare l'impronta digitale.
deunaSDK.generateFraudId(
context = context,
params = mapOf(
"RISKIFIED" to mapOf(
"storeDomain" to "deuna.com"
)
),
callback = { fraudId ->
}
)- Ottieni il valore dell’impronta digitale del dispositivo e invialo tramite Acquisto 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 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_CREDENTIALSoggetto 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:
<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:
const fraudId = await DeunaSDK.generateFraudId({
SIGNIFYD: { email: "<email from user session>" }
});