Passa al contenuto principale
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_shadowmode field.
  • Acquisire la risposta API — contiene anche lo stesso fraud_shadowmode object.

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.

  1. Vai alla sezione Commercio nel Portale Amministratore DEUNA.
  2. Aprire la scheda Impostazioni di pagamento.
  3. 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.

Esempio interattivoUsa dati di esempio e non effettua richieste API.
Produzione
Pagamenti

Strategie di pagamento

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

Acme LATAM · Produzione

Elaborazione predefinita

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

RegolaInstradamentoStatoAzione
Elaborazione predefinitaAdyen → WorldpayAttiva

Regole specifiche

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

1 regola di esempioProcessori di pagamento
PrioritàRegolaCondizioniInstradamentoStato
1Ordini di importo elevatoImporto superiore a 100 USDAdyen → WorldpayAttiva
  1. Vai alla sezione Strategie di pagamento.
  2. Creare una nuova strategia o modificare una esistente.
  3. Passa alla sezione Impostazioni Fraud.
  4. 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:

  1. Navigare alla pagina Dettagli Ordine.
  2. Scorrere verso il basso per la sezione Sicurezza.
  3. Verrà visualizzata una sottosezione chiamata “Anti-fraud provider (Modalità ombra).
  4. 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

JSON
"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:

CampoTipoDescrizione
fraud_shadowmodearrayElenco delle valutazioni antifrode eseguite in modalità ombra.
analysisobjectAnalisi dettagliata antifraud restituita dal processore.
analysis.processorstringAntifraud provider che ha eseguito l'analisi.
analysis.fraud_decisionstringDecisione della frode rilasciata dal responsabile del trattamento.
analysis.risk_levelstringLivello di rischio assegnato alla transazione.
analysis.detailsstringDettaglio decisione leggibile dall'uomo.
analysis.processor_responsestringRisposta cruda restituita dal fornitore antifraud.
analysis.scorenumberPunteggio 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.statusstringTipo di esecuzione della decisione.
analysis.typestringCampo riservato per i tipi di classificazione o di regola futuri.
statusstringEsito di transazione consigliato basato sull'analisi antifraud.
Stato Comportamento
analysis.fraud_decisionanalysis.risk_levelstatus
low_risklowaccepted
high_riskhighrejected
medium_riskmediummanual_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.