Modalità ombra
In questa pagina
Shadow Mode permette ai commercianti di valutare uno o più fornitori anti-frode in parallelo senza interrompere il flusso di transazione.
Questo è particolarmente utile per confrontare le prestazioni di rilevamento delle frodi o calibrare i modelli utilizzando i dati in tempo reale, senza avere impatto sulle approvazioni dal vivo o sull'esperienza del cliente.
Come funziona?#
Quando la modalità Shadow è abilitata, DEUNA elabora ogni transazione attraverso entrambi i fornitore principale anti-frode e la fornitore ombra.
Il fornitore di ombre corre in parallelo e riceve gli stessi dati di transazione del fornitore principale. Tuttavia, la sua valutazione fa non influisce la decisione di acquisto o il flusso di pagamento — è eseguito solo per scopi di confronto e monitoraggio.
Una volta completata la transazione, DEUNA include il risultato di valutazione dal provider ombra nella risposta API. Il risultato è riportato nel fraud_shadowmode oggetto, che rispecchia la struttura della principale risposta alle frodi.
È possibile accedere al risultato della modalità ombra nei seguenti modi:
- GET /order — la risposta del fornitore di ombre è inclusa nel
fraud_shadowmodefield. - Acquisire la risposta API — contiene anche lo stesso
fraud_shadowmodeobject.
Questo consente di confrontare in modo sicuro i risultati di entrambi i fornitori, identificare discrepanze nella valutazione del rischio e prendere decisioni basate sui dati prima di cambiare i fornitori o aggiornare la strategia di frode.
Configurazione#
Per abilitare la modalità Shadow, è necessario definire un fornitore di ombre all'interno della configurazione di strategia di frode. Il fornitore di ombre riceve la stessa richiesta di transazione come quella principale, ma la sua valutazione viene eseguita silenziosamente e non blocca mai o approva un pagamento.
Se il tuo fornitore selezionato richiede un dispositivo di impronta digitale, DEUNA riutilizza automaticamente il valore di impronta digitale inviato nella principale API call. Solo una impronta è supportato per transazione, e lo stesso valore è condiviso tra i principali e fornitori di ombre.
Questo garantisce dati coerenti attraverso le valutazioni, evitando di scoring errato a causa di diverse impronte digitali.
1. Attiva la modalità ombra
Il primo passo per configurare la modalità ombra nelle tue strategie di pagamento è abilitarlo a livello del commerciante.
- Vai alla sezione Commercio nel Portale Amministratore DEUNA.
- Aprire la scheda Impostazioni di pagamento.
- Nella sezione Impostazioni Fraud, abilitare la funzione di attivazione:
Attivare il fornitore antifrode in modalità ombra La modalità Shadow consente una valutazione sincrona delle frodi senza impedire che la transazione venga elaborata dal processore di pagamento.
Una volta abilitata questa impostazione, la modalità Shadow può essere configurata all'interno delle tue strategie di pagamento.
2. Configurare la modalità ombra
Configurare la modalità Shadow per una strategia di pagamento selezionando uno o più fornitori anti-frode per eseguire in modalità ombra.
Strategie di pagamento
Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.
Elaborazione predefinita
Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.
| Regola | Instradamento | Stato | Azione |
|---|---|---|---|
| Elaborazione predefinita | Adyen → Worldpay | Attiva |
Regole specifiche
Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.
| Priorità | Regola | Condizioni | Instradamento | Stato |
|---|---|---|---|---|
| 1 | Ordini di importo elevato | Importo superiore a 100 USD | Adyen → Worldpay | Attiva |
- Vai alla sezione Strategie di pagamento.
- Creare una nuova strategia o modificare una esistente.
- Passa alla sezione Impostazioni Fraud.
- Trova l'area Modalità Ombra e scegli i provider che desideri testare.
È possibile assegnare diversi fornitori per:
- Flusso di pre-autorizzazione
- Flusso di post-autorizzazione
I provider multipli possono essere configurati per flusso.
3. Visualizza i risultati della modalità Shadow
Una volta che la modalità Shadow è attiva e una transazione viene elaborata, è possibile visualizzare i risultati nei dettagli dell'ordine o nella risposta API.
3.1 Visualizzare il risultato nei dettagli dell'ordine:
- Navigare alla pagina Dettagli Ordine.
- Scorrere verso il basso per la sezione Sicurezza.
- Verrà visualizzata una sottosezione chiamata “Anti-fraud provider (Modalità ombra).
- Per ogni fornitore di ombre, vedrai:
- Nome del fornitore
- Punteggio del rischio
- Livello di rischio (ad esempio, basso, medio, alto)
- Risposta del processore e qualsiasi dettaglio rilevante
I risultati della modalità ombra possono essere anche riesaminati dal Visibilità della transazione sezione nella pagina dei dettagli dell'Ordine.
Sarete in grado di controllare la richiesta e la risposta inviata al fornitore ombra, permettendo di confrontarla con il comportamento del fornitore principale.
3.2 Visualizza i risultati della modalità Shadow nella risposta API
La risposta include la fraud_shadowmode oggetto dove è possibile trovare l'elenco dei fornitori antifraud configurati e i risultati di ciascuno
"fraud_shadowmode": [
{
"analysis": {
"details": "approved",
"fraud_decision": "low_risk",
"processor": "RISKIFIED",
"processor_response": "approved",
"risk_level": "low",
"score": "0",
"status": "automatic_decision",
"type": ""
},
"status": "accepted"
}
]Questo oggetto ha i seguenti parametri:
| Campo | Tipo | Descrizione |
|---|---|---|
fraud_shadowmode | array | Elenco delle valutazioni antifrode eseguite in modalità ombra. |
analysis | object | Analisi dettagliata antifraud restituita dal processore. |
analysis.processor | string | Antifraud provider che ha eseguito l'analisi. |
analysis.fraud_decision | string | Decisione della frode rilasciata dal responsabile del trattamento. |
analysis.risk_level | string | Livello di rischio assegnato alla transazione. |
analysis.details | string | Dettaglio decisione leggibile dall'uomo. |
analysis.processor_response | string | Risposta cruda restituita dal fornitore antifraud. |
analysis.score | number | Punteggio di rischio assegnato alla transazione. Ritorna. 0 quando non viene recuperato dal fornitore antifraud. Alcuni antifraudati, come Riskified, non ritornano a scoring nella loro risposta. |
analysis.status | string | Tipo di esecuzione della decisione. |
analysis.type | string | Campo riservato per i tipi di classificazione o di regola futuri. |
status | string | Esito di transazione consigliato basato sull'analisi antifraud. |
Stato Comportamento
analysis.fraud_decision | analysis.risk_level | status |
|---|---|---|
low_risk | low | accepted |
high_risk | high | rejected |
medium_risk | medium | manual_review |
Note / Limitazioni#
- Un fornitore non può essere configurato come entrambi principale e ombra ombra fornitore nella stessa strategia di frode.
- La modalità Shadow funziona in parallelo e non influisce sulle decisioni di pagamento o sulla latenza delle transazioni in condizioni normali.
- Se il fornitore di ombre non risponde, non interromperà la valutazione del fornitore principale.
Inoltre, le transazioni elaborate in modalità ombra sono pienamente visibili nella Visibilità della transazione sezione del cruscotto. Puoi controllare entrambi i casi. richiesta e risposta inviato al fornitore di ombre per capire come la sua valutazione differisce dall'output del tuo fornitore principale.