Análisis de Billeteras: Antes o Después de la Transferencia (ES)

Hay dos momentos para analizar una transacción de criptomonedas, y responden a dos preguntas diferentes. Antes de que se mueva el valor, se analiza la dirección de la billetera para decidir si permitir que la transacción ocurra. Después de que el valor se liquida, se analiza el hash de la transacción para registrar lo que realmente se movió y reevaluarlo según la inteligencia más reciente. El primero es una puerta; el segundo es un registro.

La API de Análisis de Billeteras de Didit soporta ambos. El análisis pre-transferencia toma una dirección de billetera y devuelve un veredicto de riesgo antes de que usted acepte un depósito o libere un retiro. El análisis post-transferencia toma un hash de transacción y evalúa una transacción confirmada a posteriori. Ambos devuelven la misma puntuación de riesgo de 0 a 100 con bandas BAJA/MEDIA/ALTA/CRÍTICA y un desglose por fuente de fondos, y ambos cuestan $0.02 por análisis.

Esta guía explica la diferencia y cómo integrar cada uno en un flujo real.

Puntos clave

• Pre-transferencia = dirección, antes de que se mueva el valor. Analice una dirección de billetera para controlar un depósito o retiro antes de que ocurra.
• Post-transferencia = hash de transacción, después de la liquidación. Analice una transacción confirmada (por payment_reference_id) para fines de registro y revisión continua.
• Misma estructura de veredicto para ambos — una puntuación de riesgo de 0 a 100, una banda BAJA/MEDIA/ALTA/CRÍTICA y exposición por categoría de fuente de fondos.
• Use ambos juntos en la mayoría de los flujos: pre-transferencia para decidir, post-transferencia para documentar y verificar de nuevo.
• Activado por currency_kind: "crypto" más una dirección (INBOUND / OUTBOUND); se puede anular por llamada con include_crypto_screening.
• $0.02 por análisis con BYOK (Crystal o Merkle Science), independientemente del momento que utilice.

Qué analiza cada uno

El análisis pre-transferencia evalúa una dirección de billetera. Aún no sabe si se moverá algún valor — pregunta, "si acepto fondos de (o envío fondos a) esta dirección, ¿a qué estoy expuesto?" La API rastrea el historial de entrada y salida de la dirección y devuelve su riesgo. Este es el punto de decisión: aprobar, retener para revisión o rechazar antes de que algo se liquide.

El análisis post-transferencia evalúa una transacción específica por su hash. El valor ya se ha movido; usted está registrando el riesgo de lo que sucedió y manteniéndolo actualizado. Debido a que las etiquetas en cadena evolucionan — una dirección puede agregarse a una lista de sanciones después de que usted haya realizado una transacción con ella — el análisis post-transferencia (y el re-análisis periódico) mantiene sus registros precisos para auditorías y obligaciones de monitoreo continuo.

Por qué es importante

Elegir el momento equivocado crea lagunas reales. Si solo analiza post-transferencia, ya ha aceptado los fondos antes de saber que eran riesgosos — ahora está deshaciendo una transacción liquidada en lugar de rechazar una pendiente. Si solo analiza pre-transferencia, sus registros se vuelven obsoletos: el veredicto que capturó en el momento del depósito no refleja la inteligencia que surgió después, lo que debilita cualquier rastro de auditoría y omite las designaciones de sanciones retroactivas.

Tanto los reguladores como las buenas prácticas apuntan a la misma respuesta: ponga una puerta al principio con el análisis pre-transferencia, luego mantenga un registro preciso y verificable con el análisis post-transferencia. Usar ambos es la razón por la que el precio de $0.02 por análisis es importante — a ese costo, analizar dos veces sigue siendo un orden de magnitud más barato que un solo análisis en una suscripción heredada.

Detalles técnicos

Ambos modos se ejecutan en la API unificada /v3/ dentro de Monitoreo de Transacciones. La diferencia está en si se pasa una dirección de billetera o una referencia de transacción.

Pre-transferencia — analizar una dirección antes de aceptar un depósito:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "dep_61a0",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x4d2a...91bc",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "RECEIVER" }
  }'

Post-transferencia — analizar una transacción liquidada por su hash:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "wd_77f3",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "OUTBOUND",
    "payment_reference_id": "0xabc123...def",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "SENDER" }
  }'

Ambos devuelven la misma estructura de veredicto:

{
  "wallet_screening": {
    "risk_score": 41,
    "risk_band": "MEDIUM",
    "exposure": [
      { "category": "HIGH_RISK_EXCHANGE", "type": "DIRECT", "share": 0.27 }
    ]
  }
}

El activador. El análisis se dispara cuando currency_kind es "crypto" y se establece una direction (INBOUND u OUTBOUND). El valor predeterminado — si las transacciones de criptomonedas se analizan automáticamente — se configura en Console → Transactions → Settings, y include_crypto_screening lo anula por llamada.

El campo clave. Pase una wallet_address para pre-transferencia; pase el hash de la transacción como payment_reference_id para post-transferencia.

Precio. $0.02 por análisis, en cualquiera de los modos, con BYOK (Crystal o Merkle Science).

Cuándo usar cada uno

Escenario	Uso	Por qué
Aceptando un depósito	Pre-transferencia (dirección)	Decida antes de que los fondos sean suyos
Liberando un retiro	Pre-transferencia (dirección de destino)	Bloquee el envío a una billetera riesgosa
Registrando una transferencia liquidada	Post-transferencia (hash)	Rastro de auditoría preciso de lo que se movió
Re-análisis periódico	Post-transferencia (hash)	Detectar designaciones de sanciones retroactivas
Tanto control como mantenimiento de registros	Ambos	Controle al principio, documente después

Casos de uso

• Intercambios de criptomonedas — pre-transferencia en cada depósito y retiro para controlar el flujo; post-transferencia para mantener un registro completo y verificable.
• Rampas de entrada/salida (on/off-ramps) — pre-transferencia para bloquear conversiones que involucren billeteras de alto riesgo antes de la liquidación.
• Custodios — pre-transferencia en la entrada, re-análisis post-transferencia de activos almacenados a medida que las etiquetas evolucionan.
• Billeteras — pre-transferencia para advertir a un usuario antes de que envíe a una dirección marcada.
• VASPs — registros post-transferencia emparejados con datos de la Regla de Viaje para un rastro de cumplimiento defendible.

Cómo integrar con Didit

1. Establezca el valor predeterminado en Transactions → Settings — elija si las transacciones de criptomonedas se analizan automáticamente y qué clave de proveedor usar.
2. Controle al principio. Antes de aceptar un depósito o liberar un retiro, POST /v3/transactions/ con la wallet_address y actúe según la banda.
3. Registre después de la liquidación. Una vez que se confirma una transacción, analícela de nuevo con el hash como payment_reference_id.
4. Gestione las alertas. Los análisis de riesgo ALTO/CRÍTICO abren alertas en el gestor de casos integrado para investigación y presentación de SAR.

Preguntas frecuentes

¿Cuál es la diferencia práctica entre el análisis pre y post-transferencia?

El análisis pre-transferencia analiza una dirección de billetera antes de que se mueva el valor, para que pueda rechazarlo. El análisis post-transferencia analiza una transacción liquidada por su hash, para que tenga un registro preciso y verificable.

¿Necesito hacer ambos?

La mayoría de los equipos deberían. El análisis pre-transferencia controla el flujo; el análisis post-transferencia mantiene los registros actualizados — incluyendo la detección de direcciones añadidas a las listas de sanciones después de haber realizado la transacción.

¿Cómo analizo un hash de transacción?

Pase el hash como payment_reference_id en POST /v3/transactions/ con currency_kind: "crypto" y una dirección.

¿Ejecutar ambos cuesta el doble?

Sí, $0.02 cada uno, pero a ese precio dos análisis siguen siendo mucho más baratos que un solo análisis en una suscripción de análisis de blockchain heredada.

¿Puedo activar el análisis solo para algunas transacciones?

Sí. Establezca un valor predeterminado en Console → Transactions → Settings y anule por llamada con include_crypto_screening.

¿Listo para empezar?

Lea la descripción general del análisis de billeteras en la documentación, vea cómo encaja en la plataforma en la página del producto de análisis de billeteras, y verifique los precios por llamada en la página de precios. Cuando esté listo, empiece gratis — 500 verificaciones KYC gratuitas cada mes, y análisis de billeteras a $0.02 por análisis.