Saltar al contenido principal
En esta página

Las decisiones de fraude y los resultados de los pagos son independientes. Una decisión de fraude aceptada no prueba que un pago haya sido autorizado, capturado o liquidado; una decisión de fraude rechazada no prueba que se hayan revertido fondos previamente reservados o recaudados.

Lea cada valor de su campo real:

CampoPropósitoValores públicos
fraud.statusEstado general del proceso de fraude. En una carga útil envuelta en orden: order.fraud.status.pending, in_review, accepted, rejected
fraud.analysis.statusEstado informado para el análisis del proveedor seleccionado.automatic_decision, manual_review, pending_analysis, denied, accepted
fraud.analysis.fraud_decisionDecisión de riesgo normalizada utilizada por política y enrutamiento.high_risk, medium_risk, low_risk, pending_risk, manual_review, manual_denied, manual_approved
payment.data.statusCiclo de vida de los pagos financieros.Consulta Flujo y estados de pago.

No combine estos campos en una enumeración, incluso cuando dos campos contengan palabras similares.

Proceso de fraude general#

Este diagrama se aplica sólo a fraud.status. Los nodos redondeados completan la decisión de fraude, no el ciclo de vida del pago.

Diagrama de flujo
Immediate acceptanceImmediate rejectionManual or asynchronousreviewApprovedRejected1pendingEvaluation started2in_reviewMore analysis required3acceptedDECISION COMPLETE4rejectedDECISION COMPLETE5acceptedDECISION COMPLETE6rejectedDECISION COMPLETE
Revisión o pendienteResultadoExcepción o detención
fraud.statusSignificadoManejo comercial
pendingLa investigación del fraude no ha arrojado un resultado global.Mantenga activa la política de revisión configurada y evalúe el estado de pago por separado.
in_reviewSe requiere una revisión adicional o un análisis asincrónico.Espere hasta que se complete la decisión sobre fraude. No cumplir únicamente porque el pago se adelantó.
acceptedEl proceso de fraude general aceptó la transacción.Continúe según la política y luego verifique el estado de pago real.
rejectedEl proceso de fraude general rechazó la transacción.Aplique la política de rechazo o reversión configurada, luego verifique cualquier reembolso requerido o anulación del estado de pago.

Análisis de proveedores#

fraud.analysis.status describe cómo el proveedor antifraude seleccionado produjo o está produciendo su análisis. La API no define una secuencia de transición universal para todos los proveedores, por lo tanto, trátelos como resultados del análisis del proveedor, no como una segunda máquina de estado de pago.

Diagrama de flujo
Still runningAutomated policyReview requiredAcceptance resultDenial result1Provider analysis2pending_analysisWaiting3automatic_decisionAutomated result4manual_reviewHuman review5acceptedProvider accepted6deniedProvider denied
Proveedor o procesadorRevisión o pendienteResultadoExcepción o detención

automatic_decision dice cómo se produjo el análisis; no es por sí solo una aprobación. leer fraud.analysis.fraud_decision, nivel de riesgo, puntuación y detalles juntos. Los campos de respuesta específicos del proveedor pueden contener valores de diagnóstico adicionales y no deben reemplazar los campos públicos normalizados.

Flujos de preautorización y postautorización#

La detección de fraude puede ejecutarse antes o después de la operación del procesador según la ruta configurada.

Diagrama de secuencia
1Merchant backend2DEUNA3Anti-fraud provider4Payment providerCreate paymentPre-authorization evaluation whenconfiguredFraud decisionPurchase or authorization when policyallowsPayment resultPost-authorization evaluation whenconfiguredFraud decisionFraud fields + payment status
Comercio o clienteDEUNAProveedor o procesador

En un rechazo posterior a la autorización, puede que ya exista una autorización o un pago cobrado. Siga la política configurada y confirme la real payment.data.status; No asuma que la respuesta al fraude generó una anulación o un reembolso.

La selección del proveedor de fraude, el momento de la autorización previa y posterior, la revisión manual y el comportamiento de reversión resultante dependen de la configuración del comerciante y del procesador. Solicite a su DEUNA TAM que confirme y habilite el comportamiento requerido.

Maneja las actualizaciones de forma segura#

  1. Tienda fraud.status, fraud.analysis.status, fraud.analysis.fraud_decisiony payment.data.status separately.
  2. Mantenga el cumplimiento bloqueado mientras la política de fraude aplicable esté pendiente o en revisión.
  3. Trate la aceptación del fraude como un permiso para continuar con el flujo configurado, no como una confirmación financiera.
  4. Después del rechazo del fraude, inspeccione el historial de pagos y espere a que se requiera voided o refunded result.
  5. Procese webhooks repetidos de forma idempotente y conserve las referencias de proveedores para la conciliación.
  6. Preservar valores desconocidos y conciliarlos; Nunca asigne un valor de fraude desconocido al éxito del pago.

Consulta Flujo y estados de pago para las transiciones financieras y Webhooks de DEUNA para configurar notificaciones.