Puntuación de Riesgo de Transacciones en Tiempo Real por $0.02 (ES)

El monitoreo por lotes es un monitoreo posterior al hecho. Ejecuta tus reglas durante la noche y descubres que un pago fue sospechoso la mañana después de que se liquidó, cuando el dinero ya se ha ido y lo único que queda por hacer es presentar un informe. La calificación en tiempo real cambia eso: evalúas la transacción mientras aún está en curso, obtienes una decisión en milisegundos y actúas antes de la liquidación.

La API de Monitoreo de Transacciones de Didit califica cada transacción en línea. Envías el pago, el motor lo ejecuta contra cada regla activa, adjunta una puntuación de riesgo y devuelve uno de cuatro estados: APROBADA, EN_REVISIÓN, RECHAZADA o ESPERANDO_USUARIO. Los pagos de bajo riesgo pasan silenciosamente; los arriesgados se retienen, bloquean o se devuelven al usuario. Funciona para dinero fiduciario y criptomonedas, y cuesta $0.02 por transacción sin mínimos.

Esta guía explica cómo funciona la calificación, qué significan los cuatro estados y cómo actuar sobre ellos antes de que se mueva el dinero.

Puntos clave

• Toma de decisiones en tiempo real. Cada transacción se califica en línea y devuelve un estado en milisegundos, para que puedas actuar antes de que se liquide el dinero.
• Cuatro estados: APROBADA, EN_REVISIÓN, RECHAZADA, ESPERANDO_USUARIO — un resultado claro y accionable para cada pago.
• Una puntuación de riesgo numérica acompaña el estado, acumulada de las reglas que se activaron, para que puedas establecer tus propios umbrales.
• Las reglas impulsan la puntuación — la acción de cada regla puede sumar a la puntuación, cambiar el estado, etiquetar la transacción o listar una parte.
• Dinero fiduciario y cripto en un solo motor, calificados de la misma manera; las criptomonedas pueden activar automáticamente el escaneo de billeteras en cadena.
• $0.02 por transacción, pago por llamada, sin mínimos. El escaneo AML de una parte marcada se factura por separado a $0.20.

Qué hace la calificación de riesgo en tiempo real

Cada transacción que envías se evalúa contra el conjunto completo de reglas activas en cada paquete habilitado. Cada regla que coincide contribuye: puede sumar a una puntuación de riesgo acumulativa, cambiar el estado, agregar etiquetas o notas para un analista, o agregar una parte a una lista. El resultado son dos cosas sobre las que actúas: una puntuación numérica que resume cuán riesgosa cree el motor que es la transacción, y un estado que te dice qué hacer al respecto.

Debido a que la evaluación ocurre en línea, la decisión se devuelve antes de que se liquide. Un pago limpio es APROBADO y procede sin fricción. Un pago que cruza un umbral suave pasa a EN_REVISIÓN y abre una alerta. Un pago que activa una regla estricta —una contraparte sancionada— es RECHAZADO. Y un pago que es riesgoso pero recuperable pasa a ESPERANDO_USUARIO, en pausa para un paso adicional que el usuario puede completar.

Por qué es importante

El valor total del monitoreo reside en el momento. Detectar una estructuración o una contraparte sancionada un día tarde significa que los fondos ya se han ido; todo lo que puedes hacer es informar. Detectarlo en el momento significa que puedes retener el pago, rechazarlo o remediarlo — detienes el daño en lugar de documentarlo.

La calificación en tiempo real también cambia la economía. Los sistemas por lotes obligan a una elección contundente entre bloquear demasiado y revisar todo. Una puntuación por transacción con cuatro estados distintos te permite calibrar: aprobar automáticamente la mayoría limpia, revisar lo genuinamente ambiguo, rechazar firmemente lo inequívoco y devolver los casos recuperables al usuario. El tiempo del analista se dedica solo donde se necesita, y a $0.02 por transacción el costo sigue el volumen en lugar de las licencias por puesto.

Detalles técnicos

Las transacciones se crean contra la API unificada /v3/, idempotente en un transaction_id que controlas:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_e02b7c",
    "category": "finance",
    "amount": 15000,
    "currency": "EUR",
    "currency_kind": "fiat",
    "txn_date": "2026-05-21T15:22:00Z",
    "subject": { "vendor_data": "user_2204", "role": "SENDER", "entity_type": "INDIVIDUAL" },
    "counterparty": { "role": "RECEIVER", "entity_type": "INDIVIDUAL" },
    "payment_method": "BANK_TRANSFER"
  }'

La respuesta lleva la puntuación de riesgo, el estado y las reglas que contribuyeron:

{
  "transaction_id": "txn_e02b7c",
  "status": "IN_REVIEW",
  "risk_score": 61,
  "triggered_rules": [
    { "name": "Large transaction", "bundle": "Finance", "action": "ADD_SCORE" },
    { "name": "New account — high value", "bundle": "AML/CTF", "action": "CHANGE_STATUS" }
  ],
  "alert_id": "alrt_3f90aa"
}

Los cuatro estados:

Estado	Significado
APPROVED	Ninguna regla cruzó un umbral de rechazo — la transacción procede.
IN_REVIEW	Una regla marcó la transacción — se abre una alerta para un analista.
DECLINED	Una regla estricta (ej. contraparte sancionada) bloqueó la transacción.
AWAITING_USER	La transacción está retenida a la espera de una acción del usuario — reverificación o prueba de fondos.

Webhooks. Suscríbete a transaction.created y transaction.status.updated para que tu libro mayor refleje la decisión y cualquier cambio posterior cuando un analista resuelva una alerta o se complete una remediación.

Precio. $0.02 por transacción, facturado por llamada, sin mínimos. El escaneo AML de una parte marcada se factura por separado a $0.20.

Actuar antes de la liquidación

El objetivo de la calificación en línea es que el estado llegue a tiempo para hacer algo:

• APROBADA — liberar el pago. Sin fricción, sin analista.
• EN_REVISIÓN — retener o liquidar y observar según tu política; una alerta ya está abierta para que un analista la investigue.
• RECHAZADA — bloquear el pago por completo; la transacción nunca se liquida.
• ESPERANDO_USUARIO — pausar y solicitar al usuario un paso adicional; la transacción se reanuda automáticamente una vez que la completa.

Estableces los umbrales que mapean la puntuación numérica a tus propias acciones internas, además de los estados que devuelve el motor. Una puntuación de 60 podría ser una retención para un producto y una liquidación y observación para otro — el motor te da el número y el estado; tu política decide la consecuencia.

Casos de uso

• Fintech — calificar depósitos, transferencias y retiros en línea; retener transferencias de alto valor por primera vez para revisión antes de que se liquiden.
• Cripto — calificar transacciones en cadena y activar el escaneo de billeteras en la dirección de la contraparte antes de que se realice una transferencia saliente.
• Préstamos — calificar desembolsos para señales de identidad sintética y mulas antes de liberar los fondos.
• Mercados — calificar pagos a vendedores por patrones de velocidad y abuso de reembolsos antes de que se mueva el dinero.
• iGaming — calificar depósitos por picos de velocidad que también sirven como una señal de juego responsable.

Cómo integrarse con Didit

1. Configurar reglas y umbrales. En la Consola de Negocios, activa los paquetes que se ajusten a tu negocio y establece los umbrales de puntuación que se correspondan con tus acciones.
2. Calificar en línea. POST /v3/transactions/ de forma síncrona desde tu ruta de pago, con un transaction_id estable y vendor_data que vincule cada uno a su usuario.
3. Actuar según el estado. Aprobar, retener, rechazar o solicitar remediación según el estado y la puntuación devueltos.
4. Sincronizar con webhooks. Escuchar transaction.status.updated para reaccionar cuando un analista resuelva una alerta o se complete un paso ESPERANDO_USUARIO.

Debido a que todo está en la API unificada /v3/, un usuario incorporado con flujos KYC directamente en el mismo motor que califica sus transacciones — una plataforma de identidad y fraude, de principio a fin.

Preguntas frecuentes

¿Qué tan rápida es la calificación?

Es en tiempo real — la transacción se califica en línea y devuelve un estado en milisegundos, para que puedas actuar antes de que se liquide el dinero.

¿Qué representa la puntuación de riesgo?

Un resumen numérico de cuán riesgosa juzgó el motor la transacción, acumulado de las reglas que se activaron. Acompaña el estado, para que puedas establecer tus propios umbrales además de los cuatro resultados incorporados.

¿Cuáles son los cuatro estados?

APROBADA, EN_REVISIÓN, RECHAZADA y ESPERANDO_USUARIO. Aprobada procede, en revisión abre una alerta, rechazada bloquea el pago y esperando usuario pausa para un paso adicional que el usuario puede completar.

¿También califica transacciones de criptomonedas?

Sí. Establece currency_kind en fiat o crypto. Las transacciones de criptomonedas se califican de la misma manera y pueden activar automáticamente el escaneo de billeteras en cadena.

¿Cuánto cuesta?

$0.02 por transacción, facturado por llamada sin mínimos. El escaneo AML de una parte marcada se factura por separado a $0.20.

¿Listo para empezar?

Lee la descripción general de Monitoreo de Transacciones en la documentación, mira cómo encaja con el resto de la plataforma en la página del producto Monitoreo de Transacciones, y consulta los precios transparentes por llamada en la página de precios. Cuando estés listo, comienza gratis — 500 verificaciones KYC gratuitas cada mes, y monitoreo de transacciones a $0.02 por llamada.