Saltar al contenido principal
— Referencia

Audita decisiones antifraude con el log de acciones antifraude

Cada decisión de aprobación o rechazo contra un pedido de Shopify en Alva Digital Downloads se registra como una fila FraudCheckAction ligada al ID del pedido, la compra, el nivel de riesgo y la marca de tiempo. El log es el rastro de auditoría para investigar disputas y detectar aprobaciones accidentales.

Qué se registra

Se crea una fila FraudCheckAction cuando un pedido valorado como HIGH (o MEDIUM, cuando el umbral de alto riesgo está activado) por Shopify Risk Analysis aterriza en la cola. Cada fila almacena:

  • ID de pedido — el GID de pedido de Shopify, una fila por compra del pedido.
  • Nivel de riesgoHIGH, MEDIUM o LOW tal como devuelve Shopify.
  • Decisiónapproved como tri-estado: null (pendiente), true (aprobado), false (rechazado).
  • Creado en — la marca de tiempo en la que se marcó el pedido.
  • Bandera de auto-fulfillment — si el fulfillment de Shopify se aplazó hasta la aprobación.

Aprobar y rechazar son los únicos dos tipos de acción. No hay una entrada de revocación separada — revocar el acceso tras la entrega es una operación distinta en la página de Pedido.

Dónde verlo

Abre Pedidos marcados en la navegación izquierda del panel de Alva. La página tiene dos pestañas:

  • Activos — decisiones pendientes (approved = null), las más antiguas primero.
  • Archivo — decisiones pasadas, donde viven las filas rechazadas.

Las filas aprobadas no se conservan en la pestaña Archivo. Tras la aprobación, Alva borra la fila FraudCheckAction como parte de la cadena de limpieza. El rastro de auditoría de una aprobación vive en el registro Purchase como fraudCheckPassed = true, visible inline en la página de detalle del pedido.

Captura de pantalla necesaria

Panel de Alva → Pedidos marcados → pestaña Archivo. Muestra la tabla con tres filas rechazadas de ejemplo: ID de pedido, fecha de marcado, nivel de riesgo (distintivos HIGH y MEDIUM), columna de auto-fulfillment y un distintivo de estado mostrando "Rechazado" en rojo. La pestaña Activos visible pero no seleccionada. Sin datos reales de cliente visibles.

La pestaña Archivo de Pedidos marcados, mostrando decisiones rechazadas conservadas como historial de auditoría.

Filtrado y exportación

La página Pedidos marcados carga hasta las 500 filas más recientes por tienda, ordenadas de más nuevas a más antiguas. Usa la barra de filtros encima de cada tabla para acotar:

  • Búsqueda por ID de pedido — coincidencia de subcadena sin distinción de mayúsculas contra el GID.
  • Nivel de riesgo — chips de selección múltiple para HIGH, MEDIUM, LOW.

El filtrado por rango de fechas y la atribución de quien decidió (usuario) no están expuestos en la UI actual del panel. No hay exportación a CSV integrada para el log antifraude; las filas son visibles en la página y paginables en lotes de 20. Para una auditoría más profunda, consulta la tabla FraudCheckAction directamente vía soporte — cada fila lleva shopId, orderId, purchaseId y createdAt.

Captura de pantalla necesaria

Panel de Alva → página de detalle de pedido (app/orders/$id) para un pedido aprobado. Muestra la sección de comprobación antifraude con el distintivo de nivel de riesgo ("Alto"), la marca de tiempo de cuándo se ejecutó la comprobación y el estado "Aprobado". Muestra el historial inline de comprobación antifraude tal como aparece en la página. Sin datos reales de cliente visibles.

Una página de detalle de pedido con el historial inline de comprobación antifraude visible.

Restricción honesta

Hay dos huecos que conviene conocer. Las aprobaciones automatizadas desde Shopify Flow (la acción de Flow "Aprobar pedido") escriben en la misma fila FraudCheckAction y siguen la misma limpieza de borrado al aprobar, así que una aprobación impulsada por Flow no deja rastro en el log antifraude una vez completada — solo queda Purchase.fraudCheckPassed = true. Los pedidos POS se saltan las comprobaciones antifraude por completo; nunca se crea una fila FraudCheckAction para una venta POS, así que los pedidos POS nunca aparecen en el log en ninguna pestaña.

Preguntas frecuentes

¿Puedo deshacer una aprobación o rechazo?

Un rechazo se puede revertir: abre la pestaña Archivo en Pedidos marcados y haz clic en Aprobar en la fila rechazada. Una aprobación no se puede deshacer desde el log porque Alva borra la fila FraudCheckAction tras la aprobación. Para cortar el acceso de un pedido ya aprobado, revoca el acceso a la descarga en la página de Pedido y reembolsa o cancela en Shopify.

¿Cuánto tiempo se conserva el log de acciones antifraude?

Las filas FraudCheckAction rechazadas se conservan indefinidamente, junto con la Purchase. Solo se eliminan cuando el registro padre de purchase o de la tienda se borra (cascade delete). Las decisiones aprobadas no se conservan como filas de log; el rastro de auditoría de una aprobación vive en el registro Purchase como fraudCheckPassed = true.

¿El cliente ve algo del log de acciones antifraude?

No. El log de acciones antifraude es solo de admin. El cliente nunca ve el nivel de riesgo, la decisión ni la marca de tiempo. Ve el email de descarga cuando se aprueba un pedido y una página de pedido retenido cuando una decisión está pendiente o rechazada.

¿Te ha resultado útil?

¿Sigues atascado? Escríbenos.