Modo sombra

O Shadow Mode permite que os comerciantes avaliem um ou mais provedores antifraude em paralelo, sem interromper o fluxo da transação.

Isso é especialmente útil para comparar o desempenho da detecção de fraudes ou calibrar modelos usando dados em tempo real, sem afetar as aprovações em tempo real ou a experiência do cliente.

Como funciona?#

Quando o Shadow Mode está ativado, a DEUNA processa cada transação através do seu principal fornecedor antifraude e o provedor de sombra.

O provedor sombra é executado em paralelo e recebe os mesmos dados de transação que o provedor principal. No entanto, a sua avaliação não não afetar a decisão de compra ou o fluxo de pagamento — é executado apenas para fins de comparação e monitoramento.

Assim que a transação for concluída, a DEUNA inclui o resultado da avaliação do provedor sombra na resposta da API. O resultado é retornado no fraud_shadowmode objeto, que reflete a estrutura da principal resposta à fraude.

Você pode acessar o resultado do modo sombra das seguintes maneiras:

• GET /order — a resposta do fornecedor sombra está incluída no fraud_shadowmode field.
• Resposta da API de compra - também contém o mesmo fraud_shadowmode object.

Isso permite comparar com segurança os resultados de ambos os fornecedores, identificar discrepâncias na avaliação de riscos e tomar decisões baseadas em dados antes de mudar de fornecedor ou atualizar sua estratégia antifraude.

Configuração#

Para ativar o Shadow Mode, você deve definir um provedor shadow na configuração da sua estratégia antifraude. O provedor sombra recebe a mesma solicitação de transação que o principal, mas sua avaliação é executada silenciosamente e nunca bloqueia ou aprova um pagamento.

Se o seu provedor selecionado exigir um impressão digital do dispositivo, a DEUNA reutiliza automaticamente o valor da impressão digital enviado na chamada da API principal. Somente uma impressão digital é suportado por transação e o mesmo valor é compartilhado entre os provedores principal e sombra.

Isso garante dados consistentes em todas as avaliações, evitando pontuações incompatíveis devido a impressões digitais diferentes.

1. Ative o modo Sombra

O primeiro passo para configurar o Shadow Mode em suas estratégias de pagamento é habilitá-lo no nível do comerciante.

1. Vá para a seção Comércio no Portal do Administrador DEUNA.
2. Abra a guia Configurações de pagamento.
3. Na seção Configurações de fraude, ative a alternância:

Habilite o provedor antifraude no modo sombra O modo sombra permite uma avaliação síncrona de fraude sem impedir que a transação seja processada pelo processador de pagamento.

Depois que esta configuração estiver habilitada, o Modo Sombra poderá ser configurado em suas estratégias de pagamento.

2. Configure o modo Sombra

Configure o Modo Sombra para uma estratégia de pagamento selecionando um ou mais provedores antifraude para executar no modo sombra.

1. Vá para a seção Estratégias de pagamento.
2. Crie uma nova estratégia ou edite uma existente.
3. Navegue até a seção Configurações de fraude.
4. Encontre a área Shadow Mode e escolha os provedores que deseja testar.

Você pode atribuir diferentes provedores para:

• Fluxo de pré-autorização
• Fluxo pós-autorização

Vários provedores podem ser configurados por fluxo.

3. Veja os resultados do modo Shadow

Depois que o Shadow Mode estiver ativo e uma transação for processada, você poderá visualizar os resultados nos detalhes do pedido ou na resposta da API.

3.1 Visualize o resultado nos detalhes do pedido:

1. Navegue até a página Detalhes do pedido.
2. Role para baixo até a seção Segurança.
3. Uma subseção chamada “Provedor antifraude (modo sombra)” aparecerá.
4. Para cada provedor sombra, você verá:
   • Nome do provedor
   • Pontuação de risco
   • Nível de risco (por exemplo, baixo, médio, alto)
   • Resposta do processador e quaisquer detalhes relevantes

Ampliar

Os resultados do modo sombra também podem ser revisados no Visibilidade da transação seção na página Detalhes do pedido.

Você poderá inspecionar a solicitação e a resposta enviada ao provedor sombra, permitindo compará-la com o comportamento do provedor principal.

3.2 Visualizar os resultados do modo Shadow na resposta da API

A resposta inclui o fraud_shadowmode objeto onde você pode encontrar a lista de provedores antifraude configurados e os resultados de cada um

"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"
  }
]

Este objeto possui os seguintes parâmetros:

Comportamento de status

Notas/Limitações#

• Um provedor não pode ser configurado tanto como o principal e sombra fornecedor dentro da mesma estratégia de fraude.
• O Modo Sombra funciona em paralelo e não afeta as decisões de pagamento ou a latência das transações em condições normais.
• Se o fornecedor sombra não responder, não interromperá a avaliação do fornecedor principal.

Além disso, as transações processadas no Shadow Mode são totalmente visíveis no Visibilidade da transação seção do painel. Você pode inspecionar tanto o solicitação e resposta enviado ao provedor sombra para entender como sua avaliação difere da produção do seu provedor principal.