Regístrate

Caso de uso · AML / sanciones

API de cribado de sanciones BETA

El cribado de sanciones está en beta. Una llamada REST criba un nombre contra las listas de sanciones de la UE, la ONU, OFAC, la UK Sanctions List del Reino Unido, Australia (DFAT) y el Registro francés de congelaciones, más la US Consolidated Screening List completa de listas de control de exportación — siete fuentes, con emparejamiento difuso puntuado, explicación de la coincidencia a nivel de alias, y vigilancia por webhook.

Publicado el 16 de septiembre de 2026 · English version

Beta: las siete fuentes oficiales — seis listas de sanciones más la US Consolidated Screening List — están cargadas y se actualizan a diario. La Australian DFAT Consolidated List (Department of Foreign Affairs and Trade), CC BY 4.0, actualizada a diario, recoge las sanciones autónomas de Australia y los listados del Consejo de Seguridad de la ONU aplicados en Australia: personas, entidades y buques, actualizada según la publica el DFAT. Source: Department of Foreign Affairs and Trade website – www.dfat.gov.au (Australian Sanctions Consolidated List), licensed CC BY 4.0. Adapted by Prometiam. Cada coincidencia devuelve una puntuación de confianza, el nombre o alias exacto que la generó, y desambiguadores opcionales dob/country para controlar los falsos positivos. Incluido en el plan Professional.

El problema

El cribado de sanciones es el control AML con más probabilidad de ser revisado en una auditoría y, a la vez, el que peor se suele implementar. Los fallos habituales: consultar una sola lista (la de la UE pero no la de la ONU, o la de OFAC pero no la de la UK Sanctions List del Reino Unido), un emparejamiento exacto que no detecta variantes de transliteración, listas refrescadas semanalmente en lugar de a diario, sin puntuación de confianza ni explicación de la coincidencia. Cada lista oficial se publica en un formato distinto, con un calendario distinto, por una autoridad distinta.

El endpoint /sanctions/screen de Prometiam hace la unión de las siete fuentes, el emparejamiento difuso y la puntuación de confianza en una sola llamada, de modo que el integrador solo fija un umbral y lee las coincidencias. Para vigilancia continua, /sanctions/watchlist comprueba los nombres de tus contrapartes contra cada cambio diario de lista y llama a tu webhook cuando hay una coincidencia.

La integración en 30 segundos

# Cribar el nombre de una persona con el umbral por defecto del 80%
curl 'https://api.prometiam.com/functions/v1/risk-api/sanctions/screen?name=Juan%20Perez&threshold=80&entity_type=person' \
  -H 'Authorization: Bearer rk_live_...'

# Cribar una razón social (cualquier tipo de entidad)
curl 'https://api.prometiam.com/functions/v1/risk-api/sanctions/screen?name=Acme%20Trading%20S.A.&threshold=85' \
  -H 'Authorization: Bearer rk_live_...'

# Solo embarcaciones — buques con nombre IMO y similares
curl 'https://api.prometiam.com/functions/v1/risk-api/sanctions/screen?name=MV%20Black%20Sea&entity_type=vessel' \
  -H 'Authorization: Bearer rk_live_...'

La forma de la respuesta

{
  "data": [
    {
      "id": 90212,
      "name": "JUAN PEREZ",
      "type": "person",
      "score": 92,
      "list": "EU",
      "list_url": "https://webgate.ec.europa.eu/.../...",
      "added_on": "2024-09-12",
      "country_of_birth": null,
      "aliases": ["JUAN A. PEREZ", "J. PEREZ"]
    }
  ],
  "meta": {
    "query_ms": 47,
    "rate_limit": { "rpm_remaining": 199, "daily_remaining": 9999 }
  }
}

Cada coincidencia incluye la list de origen (EU, UN, OFAC, OFSI (la UK Sanctions List del Reino Unido, publicada por la FCDO), DFAT (Australia), FR_GELS, más listas de control de exportación de EE. UU. como US Entity List (BIS)), una puntuación de confianza score, y un enlace a la entrada oficial de la lista para auditoría. aliases es la unión de todos los nombres alternativos del registro subyacente, para que el revisor vea por qué se disparó la coincidencia.

Captura del panel de clientes: un cribado de sanciones ejecutado en la ConsolaCaptura del panel de clientes: un cribado de sanciones ejecutado en la Consola
GET /sanctions/screen en la Consola del panel: indica el nombre y el umbral, envía la petición y lee las coincidencias (3 créditos). El cribado de sanciones es beta; un cribado por nombre no es una autorización. Ábrelo en el panel

Ajuste del umbral

El parámetro threshold equilibra falsos positivos y falsos negativos:

  • 50–69: muy laxo. Útil para revisión con humano en el bucle, donde el coste de perder una coincidencia domina. La mayoría de nombres devolverán al menos una coincidencia débil.
  • 70–79: liberal. Detecta variantes de transliteración y de nombre corto. Espera una tasa de falsos positivos de ~5% en nombres comunes.
  • 80 (por defecto): equilibrado. Detecta la mayoría de variantes sin inundar a los revisores.
  • 85–90: estricto. Valor de producción habitual para procesamiento de pagos de alto volumen, donde el coste de revisión es alto.
  • 95+: casi exacto. Úsalo solo cuando ya hayas hecho el cribado completo a 80 y quieras una comprobación rápida en el camino crítico.

Buena práctica: cribar a 80 en el alta, encolar automáticamente para bloqueo las coincidencias ≥85, y enviar las de 80–84 a un revisor humano.

Documentación para cumplimiento

Toda respuesta con éxito incluye list_url, que apunta a la entrada canónica de la lista de origen. Para auditorías y reportes de operativa sospechosa, conserva en tu registro de transacciones el list_url, la fecha added_on, el nombre que hizo coincidencia y la puntuación. Combinado con la marca de tiempo de la llamada (que devuelven las cabeceras de la respuesta), eso es un rastro de auditoría defendible.

Alineado con el Reglamento (UE) 2580/2001 (sanciones antiterroristas), las resoluciones del Consejo de Seguridad de la ONU, la lista OFAC SDN estadounidense (31 CFR 501), y la Sanctions and Anti-Money Laundering Act 2018 del Reino Unido. En España, el cribado de sanciones sostiene la obligación de diligencia debida de la Ley 10/2010 de prevención del blanqueo de capitales y de la financiación del terrorismo, cuyo supervisor es el SEPBLAC; esto no constituye asesoramiento legal.

Encaje de precio

El cribado de sanciones es un alcance del plan Professional. El plan Professional (29,99 €/mes) cubre 10.000 créditos al mes, 120 peticiones por minuto — unos 3.300 nombres cribados al mes a 3 créditos cada uno. Una fintech que da de alta entre 1.000 y 5.000 contrapartes al mes con 5–10 cribados de sanciones cada una (de 15.000 a 150.000 créditos) necesita Scale (99,99 €/mes, 50.000 créditos al mes, 300 peticiones por minuto) en el extremo bajo y una asignación Enterprise más allá.

Los proveedores especializados en cribado (ComplyAdvantage, LSEG World-Check) no publican precio para un volumen equivalente: es a consulta comercial. Merecen la pena si además necesitas cobertura PEP y de reputación adversa, algo que Prometiam no ofrece. Solo para sanciones, Prometiam es sensiblemente más barato.

Límites de alcance, sin rodeos

  • Cribado de sanciones (beta): en beta.
  • Cribado PEP: en beta y solo España, sin familiares ni allegados (RCA).
  • Reputación adversa: no se ofrece.
  • Verificación de identidad: no se ofrece; el endpoint no valida documentos de identidad de personas físicas.

Preguntas frecuentes

¿Qué listas cubre?
UE consolidada, ONU, OFAC SDN, UK Sanctions List del Reino Unido, Australia (DFAT), Registro francés de congelaciones, más la US Consolidated Screening List. Una sola llamada, las siete fuentes.

¿Qué tipo de emparejamiento usa?
Difuso por trigramas. Robusto ante errores ortográficos, transliteración y puntuación. Puntuación de confianza (match_score) por coincidencia.

¿Qué tan recientes son las listas?
Actualización diaria en las siete fuentes. added_on por coincidencia, para auditoría.

¿Personas o entidades?
Ambas. entity_type = person, entity, vessel, o any (por defecto).

¿Cómo encaja esto en un flujo KYB?
Ver verificación KYB para el patrón completo con código.

¿Está en la prueba gratuita de 14 días?
Hasta 25 llamadas al mes, para probarlo. El cribado completo de sanciones es de alcance Professional.