Modo "Shadow"

El Modo Sombra permite a los comerciantes evaluar uno o más proveedores antifraude en paralelo sin interrumpir el flujo de transacciones.

Esto es especialmente útil para comparar el rendimiento de la detección de fraude o calibrar modelos utilizando datos en tiempo real, sin afectar las aprobaciones en vivo ni la experiencia del cliente.

¿Cómo funciona?#

Cuando el Modo Sombra está habilitado, DEUNA procesa cada transacción a través de su principal proveedor antifraude y la proveedor de sombra.

El proveedor paralelo se ejecuta en paralelo y recibe los mismos datos de transacciones que el proveedor principal. Sin embargo, su evaluación no no afectar la decisión de compra o el flujo de pago: se ejecuta sólo con fines de comparación y seguimiento.

Una vez que se completa la transacción, DEUNA incluye el resultado de la evaluación del proveedor paralelo en la respuesta de la API. El resultado se devuelve en el fraud_shadowmode objeto, que refleja la estructura de la principal respuesta al fraude.

Puede acceder al resultado del modo sombra de las siguientes maneras:

• GET /order — la respuesta del proveedor paralelo se incluye en el fraud_shadowmode field.
• Comprar respuesta API - también contiene lo mismo fraud_shadowmode object.

Esto le permite comparar de forma segura los resultados de ambos proveedores, identificar discrepancias en la evaluación de riesgos y tomar decisiones basadas en datos antes de cambiar de proveedor o actualizar su estrategia de fraude.

Configuración#

Para habilitar el modo sombra, debe definir un proveedor sombra dentro de la configuración de su estrategia de fraude. El proveedor paralelo recibe la misma solicitud de transacción que el principal, pero su evaluación se ejecuta de forma silenciosa y nunca bloquea ni aprueba un pago.

Si su proveedor seleccionado requiere un huella digital del dispositivo, DEUNA reutiliza automáticamente el valor de la huella digital enviado en la llamada API principal. Sólo una huella digital se admite por transacción y el mismo valor se comparte entre el proveedor principal y el paralelo.

Esto garantiza datos consistentes en todas las evaluaciones, evitando puntuaciones no coincidentes debido a diferentes huellas dactilares.

1. Habilite el modo Sombra

El primer paso para configurar el Modo Sombra en tus estrategias de pago es habilitarlo a nivel de comerciante.

1. Vaya a la sección Comercio en el Portal del Administrador de DEUNA.
2. Abra la pestaña Configuración de pago.
3. En la sección Configuración de fraude, habilite la opción:

Habilitar proveedor antifraude en modo sombra El modo sombra permite una evaluación de fraude sincrónica sin detener el procesamiento de la transacción por parte del procesador de pagos.

Una vez habilitada esta configuración, el Modo Sombra se puede configurar dentro de sus estrategias de pago.

2. Configurar el modo Sombra

Configure el modo sombra para una estrategia de pago seleccionando uno o más proveedores antifraude para ejecutar en modo sombra.

1. Vaya a la sección Estrategias de pago.
2. Cree una nueva estrategia o edite una existente.
3. Navegue a la sección Configuración de fraude.
4. Busque el área Modo Sombra y elija los proveedores que desea probar.

Puede asignar diferentes proveedores para:

• Flujo de preautorización
• Flujo posterior a la autorización

Se pueden configurar varios proveedores por flujo.

3. Ver los resultados del modo Sombra

Una vez que el Modo Sombra está activo y se procesa una transacción, puede ver los resultados en los detalles del pedido o en la respuesta API.

3.1 Ver resultado en los detalles del pedido:

1. Navegue a la página Detalles del pedido.
2. Desplácese hacia abajo hasta la sección Seguridad.
3. Aparecerá una subsección llamada "Proveedor antifraude (modo sombra)".
4. Para cada proveedor de sombra, verá:
   • Nombre del proveedor
   • Puntuación de riesgo
   • Nivel de riesgo (por ejemplo, bajo, medio, alto)
   • Respuesta del procesador y cualquier detalle relevante

Ampliar

Los resultados del modo de sombra también se pueden revisar desde la Visibilidad de transacciones sección en la página de detalles del pedido.

Podrá inspeccionar la solicitud y la respuesta enviada al proveedor paralelo, lo que le permitirá compararla con el comportamiento del proveedor principal.

3.2 Ver los resultados del modo Sombra en la respuesta de la API

La respuesta incluye la fraud_shadowmode Objeto donde se puede encontrar la lista de proveedores antifraude configurados y los resultados de cada uno.

"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 tiene los siguientes parámetros:

Comportamiento de estado

Notas / Limitaciones#

• Un proveedor no se puede configurar como principal y sombra proveedor dentro de la misma estrategia de fraude.
• El Modo Sombra se ejecuta en paralelo y no afecta las decisiones de pago ni la latencia de las transacciones en condiciones normales.
• Si el proveedor paralelo no responde, no interrumpirá la evaluación del proveedor principal.

Además, las transacciones procesadas en el Modo Sombra son completamente visibles en el Visibilidad de transacciones sección del tablero. Puede inspeccionar tanto el solicitud y respuesta enviado al proveedor paralelo para comprender en qué se diferencia su evaluación del resultado de su proveedor principal.