API de Monitoratge de Transaccions: Regles en Temps Real, Gestió de Casos i Fluxos de SAR (CA)

Integrar un usuari amb KYC et diu qui és el primer dia. No et diu res sobre el que fa el dia noranta. El monitoratge de transaccions és l'altra meitat del compliment normatiu — la capa contínua que observa el moviment de diners i detecta els patrons importants: estructuració, entrades i sortides ràpides, pics de velocitat, contraparts sancionades i jurisdiccions d'alt risc.

L'API de Monitoratge de Transaccions de Didit és un motor de regles en temps real exactament per a això. Tu envies una transacció, retorna una decisió en mil·lisegons, i qualsevol cosa que activi una regla va a parar a un gestor de casos integrat on els teus analistes investiguen, escalen i presenten Informes d'Activitat Sospitosa (SARs). Funciona tant per a fiat com per a cripto, i costa 0,02 $ per transacció sense mínims.

Aquesta guia explica com funciona, amb quins paquets de regles ve el motor i com integrar-lo.

Punts clau

• Presa de decisions en temps real. Cada transacció retorna un dels quatre estats — APPROVED, IN_REVIEW, DECLINED o AWAITING_USER — perquè puguis actuar abans que els diners s'assentin.
• 11 paquets de regles integrats cobreixen AML/CTF, detecció d'anomalies, patrons FATF, intel·ligència de dispositius, frau, monitoratge de cripto, anàlisi de cripto, joc responsable i comerç electrònic. Construeix els teus propis a sobre.
• Gestió de casos i flux de treball SAR integrats — alertes, assignació d'analistes, estats d'investigació i presentació de SARs viuen dins del mateix producte, no en una eina separada.
• L'autoremediació AWAITING_USER permet que una transacció marcada activi un pas de verificació (re-KYC, prova de fons) i es reprengui automàticament un cop l'usuari el completi.
• Fiat i cripto en un sol motor. Les transaccions de cripto poden activar automàticament l'anàlisi de wallets on-chain.
• 0,02 $ per transacció, pagament per ús, sense mínims. L'anàlisi AML d'una part marcada es factura per separat a 0,20 $ per comprovació.

Què fa el monitoratge de transaccions

Una comprovació KYC és una instantània; el monitoratge de transaccions és la pel·lícula. Un cop un usuari és integrat, cada pagament, transferència, dipòsit, retirada, aposta o operació que realitza és un senyal. Considerats individualment, la majoria d'aquests senyals són soroll. Considerats com un flux — amb finestres de velocitat, agregació i context de contrapart — els patrons que indiquen blanqueig de capitals, frau o evasió de sancions es fan visibles.

Didit puntua cada transacció a mesura que es produeix amb una biblioteca de regles, adjunta una puntuació de risc i assigna un estat. Les transaccions de baix risc passen sense problemes. Qualsevol cosa que superi un llindar es reté per a revisió, es denega directament o es redirigeix a l'usuari per a la seva remediación — i s'obre una alerta per a un analista.

Per què és important

Els reguladors esperen un monitoratge continu, no només comprovacions d'integració. Les directives AML de la UE, les recomanacions del FATF i els règims equivalents a tot el món requereixen que les empreses regulades monitoritzen les transaccions basant-se en el risc i informin d'activitats sospitoses. Els errors són costosos: estructuració no detectada, contraparts sancionades no identificades o un patró de velocitat que resulta ser una xarxa de mules.

El problema operatiu és igual de real. La majoria dels equips uneixen el monitoratge d'un proveïdor de regles, una eina de gestió de casos separada i un procés SAR manual en fulls de càlcul. Didit col·lapsa aquesta pila en una única API i una única consola: regles, alertes, investigació i informes al mateix lloc, amb preu per transacció perquè el cost s'ajusti a l'ús en lloc de llicències per usuari.

Detalls tècnics

Les transaccions es creen contra l'API unificada /v3/. Cada transacció és idempotent en un transaction_id que tu controles (únic per aplicació), de manera que les reintents mai compten doble.

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_8f3a91",
    "category": "finance",
    "amount": 9800,
    "currency": "EUR",
    "currency_kind": "fiat",
    "txn_date": "2026-05-21T10:32:00Z",
    "subject": {
      "vendor_data": "user_4521",
      "role": "SENDER",
      "entity_type": "INDIVIDUAL"
    },
    "counterparty": {
      "role": "RECEIVER",
      "entity_type": "INDIVIDUAL"
    },
    "payment_method": "BANK_TRANSFER"
  }'

El motor avalua la transacció amb totes les regles actives i retorna un estat més les regles que s'han activat:

{
  "transaction_id": "txn_8f3a91",
  "status": "IN_REVIEW",
  "risk_score": 62,
  "triggered_rules": [
    { "name": "Structuring — amount below reporting threshold", "bundle": "AML/CTF", "action": "ADD_SCORE" },
    { "name": "High velocity — sender 24h count", "bundle": "Anomaly detection", "action": "CHANGE_STATUS" }
  ],
  "alert_id": "alrt_2c70d4"
}

Estats. Cada transacció es resol en un dels quatre:

Estat	Significat
APPROVED	Cap regla ha superat un llindar de rebuig — la transacció continua.
IN_REVIEW	Una regla ha marcat la transacció — s'obre una alerta per a un analista.
DECLINED	Una regla estricta (p. ex., contrapart sancionada) ha bloquejat la transacció.
AWAITING_USER	La transacció es manté pendent d'una acció de l'usuari — reverificació o prova de fons.

Categories. Les transaccions porten una category perquè les regles s'apliquin en context: finance, kyc, travel_rule, user_platform_event, gambling_bet, gambling_limit_change, gambling_bonus_change i audit_trail_event.

Velocitat i agregació. Les regles personalitzades s'avaluen en finestres de temps amb agregacions de recompte, suma i recompte distintiu — de manera que pots expressar "més de 5 transferències entrants de contraparts diferents en 24 hores" o "volum acumulat superior a 10.000 € en 7 dies" sense escriure el teu propi processador de fluxos.

Webhooks. Subscriu-te a transaction.created i transaction.status.updated per mantenir el teu registre sincronitzat quan un analista resol una alerta.

Preu. 0,02 $ per transacció, facturat per trucada, sense mínims. Si una transacció marcada activa l'anàlisi AML d'una part, aquesta comprovació es factura per separat a 0,20 $.

Els 11 paquets de regles integrats

No comences amb un llibre de regles en blanc. Didit proporciona al motor 11 paquets que pots activar i ajustar:

1. Finances — estructuració, transaccions grans, evasió de llindars.
2. AML/CTF — volum acumulat, entrades/sortides ràpides, sancions, exposició PEP, jurisdiccions d'alt risc.
3. Detecció d'anomalies — pics de velocitat, reactivació de comptes inactius, valors atípics de comportament.
4. FATF — patrons alineats amb els indicadors de bandera vermella del FATF.
5. Intel·ligència de dispositius — empremta digital del dispositiu i senyals de risc de sessió.
6. Prevenció del frau — patrons de mules, multicompte, senyals de presa de control de comptes.
7. Monitoratge de cripto — patrons de transaccions on-chain.
8. Anàlisi de cripto — risc de wallet i exposició a l'origen dels fons.
9. Joc responsable — velocitat de dipòsit, canvis de límit, abús de bonificacions.
10. Comerç electrònic — patrons de retrocessió i abús de reemborsaments.
11. Personalitzades — les teves pròpies regles amb condicions, finestres de velocitat i agregacions.

L'acció de cada regla pot afegir a la puntuació de risc, canviar l'estat, afegir etiquetes o notes, o afegir la part a una llista — de manera que la política s'expressa de forma declarativa, i els canvis es revisen a la Consola en lloc de ser enviats en el codi.

Cripto, anàlisi de wallets i la Regla de Viatge

Estableix currency_kind: "crypto" amb una direcció (INBOUND o OUTBOUND) i el motor pot executar automàticament l'anàlisi de wallets on-chain a l'adreça de la contrapart — comprovant l'exposició a entitats sancionades, mercats de la darknet, mescladors, ransomware i fons robats. L'anàlisi de wallets comença a 0,02 $ per anàlisi amb la teva pròpia clau (Crystal o Merkle Science).

Per als Proveïdors de Serveis d'Actius Virtuals, el mateix motor inclou suport per a la Regla de Viatge del FATF: intercanvi de dades de l'originador i del beneficiari amb seguiment d'obligacions a través de protocols, i estats dedicats a la regla de viatge (COMPLIANT, PENDING_ACTION, PENDING_COUNTERPARTY, EXEMPT, i més). Un sol producte cobreix el monitoratge, l'anàlisi i la Regla de Viatge.

Gestió de casos i flux de treball SAR

Quan s'activa una regla, s'obre una alerta. Didit inclou l'entorn de treball per gestionar-la, sense necessitat d'una eina de casos separada.

• Les alertes tenen una font (activada per regla, activada per proveïdor o creada per analista) i passen per estats: OPEN, INVESTIGATING, AWAITING_USER, PENDING_SAR, SAR_FILED, RESOLVED, DISMISSED.
• Els casos agrupen alertes relacionades, tenen prioritat i gravetat, i segueixen una investigació a través de OPEN, UNDER_REVIEW, AWAITING_USER, ON_HOLD i RESOLVED.
• S'assignen analistes, el rendiment és mesurable i el flux de treball SAR es troba a la mateixa consola on es va generar l'alerta.

El camí AWAITING_USER és el que fa que això sigui pràctic a escala: en lloc d'una denegació forçada, una transacció marcada pot pausar-se i demanar a l'usuari que la resolgui — reverificar la identitat, proporcionar una prova de fons — i després reprendre's automàticament un cop l'usuari ho faci. La fricció es produeix només on hi ha risc.

Com integrar-se amb Didit

1. Construeix el flux de treball. A la Consola Empresarial, activa els paquets de regles rellevants per al teu negoci i ajusta els llindars. El constructor de regles personalitzades és només de la Consola per disseny, de manera que el compliment revisa cada canvi.
2. Envia transaccions. POST /v3/transactions/ des del teu backend a mesura que es mouen els diners. Utilitza un transaction_id estable per a la idempotència i passa vendor_data perquè les transaccions s'enllacin amb l'usuari o l'entitat comercial a la qual pertanyen.
3. Gestiona els webhooks. Escolta transaction.status.updated per reaccionar quan un analista resol una alerta o una remediación AWAITING_USER es completa.
4. Gestiona les alertes a la Consola. Investiga, escala a un cas i presenta SARs des de la mateixa interfície.

Com que tot es troba a l'API unificada /v3/, una sessió KYB pot generar les sessions KYC per als seus UBOs, aquests usuaris passen al monitoratge de transaccions, i una transacció marcada pot generar una remediación KYC — una plataforma d'identitat i frau, de principi a fi.

Preguntes freqüents

Quant costa el monitoratge de transaccions?

0,02 $ per transacció, facturat per trucada sense mínims. L'anàlisi AML d'una part marcada es factura per separat a 0,20 $ per comprovació, i l'anàlisi de wallets on-chain comença a 0,02 $ per anàlisi amb la teva pròpia clau.

Funciona tant per a cripto com per a fiat?

Sí. Estableix currency_kind a fiat o crypto. Les transaccions de cripto poden activar automàticament l'anàlisi de wallets on-chain i inclouen suport per a la Regla de Viatge del FATF.

He de construir la meva pròpia eina de gestió de casos?

No. Les alertes, l'assignació d'analistes, els estats d'investigació i el flux de treball SAR estan integrats en el mateix producte i consola.

Puc escriure les meves pròpies regles?

Sí. A més dels 11 paquets predefinits, pots construir regles personalitzades amb condicions, finestres de velocitat i agregacions. Les regles es gestionen a la Consola perquè el compliment revisi cada canvi.

Què és l'autoremediació AWAITING_USER?

En lloc d'una denegació forçada, una transacció marcada pot pausar-se i sol·licitar una acció de l'usuari — reverificació o prova de fons — i després reprendre's automàticament un cop l'usuari la resolgui.

Preparat per començar?

Llegeix la visió general del monitoratge de transaccions a la documentació, mira com encaixa amb la resta de la plataforma a la pàgina del producte de monitoratge de transaccions i consulta els preus transparents per trucada a la pàgina de preus. Quan estiguis preparat, comença de franc — 500 comprovacions KYC gratuïtes cada mes, i monitoratge de transaccions a 0,02 $ per trucada.