Saltar al contenido principal
Cada transacción que envías con un identificador vendor_data (ya sea como solicitante o como contraparte) se vincula a la entidad de usuario correspondiente. El perfil del usuario se convierte en un historial acumulado de la actividad de la persona, y la Monitorización de transacciones usa este historial para aplicar reglas de velocidad y comportamiento basadas en este historial.

​
Cómo obtener las transacciones de un usuario

Filtra la lista de transacciones por vendor_data:
Devuelve todas las transacciones en las que el usuario es el solicitante. Para el historial del lado de la contraparte, filtra en la Business Console (el endpoint público de listado solo filtra por solicitante).

​
Cómo se vinculan las transacciones a los usuarios

Cada transacción incluye hasta cuatro partes (solicitante, remitente, beneficiario y contraparte). Cuando una parte incluye vendor_data, Didit la vincula a ese usuario. Las partes sin vendor_data se almacenan como instantáneas externas (sin vínculo con ninguna entidad). Consulta envío de transacciones para ver el modelo completo de partes.

​
Señales de riesgo agregadas

Las transacciones alimentan las siguientes señales a nivel de usuario: Estas señales se calculan en tiempo real y se evalúan frente a tus reglas de transacciones activas. Cuando se cumple una regla, el usuario puede pasar automáticamente a FLAGGED o BLOCKED, según la acción de la regla.

​
Cómo actúan las reglas sobre los usuarios

Las actions de una regla de transacción pueden incluir:
  • add_score: aumenta la puntuación de riesgo de la transacción.
  • change_status: establece el estado de la transacción (IN_REVIEW, DECLINED, AWAITING_USER).
  • add_tags: etiqueta la transacción.
  • add_to_list: añade el vendor_data del usuario a una lista de bloqueo o a una lista personalizada.
Cuando una regla añade al usuario a una lista de bloqueo, su entidad de usuario pasa a BLOCKED y se dispara un webhook user.status.updated.

​
Monitorización del comportamiento de un usuario

Usa la pestaña Transactions de la página de detalle del usuario en la Business Console para:
  • Ver todas las transacciones en orden cronológico.
  • Filtrar por estado, importe, dirección y contraparte.
  • Abrir cualquier transacción para inspeccionar las ejecuciones de reglas, el enriquecimiento de IP y los resultados del análisis de criptomonedas.
  • Abrir un caso contra el usuario para hacer seguimiento de una investigación.

​
Sesiones de remediación

Cuando una transacción entra en AWAITING_USER, Didit crea una sesión de remediación vinculada que requiere que el usuario complete una verificación adicional (por ejemplo, documentación del origen de los fondos o un documento de identidad actualizado). La sesión de remediación está asociada al mismo vendor_data: al completarse, el estado de la transacción se actualiza automáticamente. Consulta estados de las transacciones para ver la máquina de estados completa.

​
Ingesta histórica

Para cargar transacciones históricas asociadas a una entidad de usuario existente, pasa un txn_date en el pasado:
Las transacciones históricas también pasan por el motor de reglas. Si quieres ingerir el historial sin disparar reglas, usa el flujo de importación de la consola, que admite un modo de “ingesta en seco” (dry ingest).

​
Próximos pasos

Enviar transacciones

Referencia completa del payload.

Reglas

Cómo las reglas evalúan las transacciones y actúan sobre los usuarios.

Estados

Referencia de los estados de transacciones y de remediación.
Última modificación el 1 de noviembre de 2026