Saltar al contenido principal
POST
Python
Envía identificadores introducidos manualmente y atributos de identidad declarados, selecciona las comprobaciones que quieres ejecutar y revisa cada resultado por separado. Usa primero Planificar una comprobación de fraude para revisar los requisitos de entrada y los cargos estimados.

Elige un perfil

Fija profile_version para que los valores predeterminados seleccionados y la política de decisión sean explícitos. El perfil predeterminado es standard, versión 2026-08-27. La versión 2026-09-14 añade el enriquecimiento social opcional de correo electrónico y teléfono, y registra cada comprobación completada como una sesión nativa de Verificación de usuarios. En esa versión, los complementos de pago son opcionales y debes activarlos expresamente. La versión 2026-09-14.1 también habilita las consultas de identificadores en la red global de fraude para las organizaciones con el plan Enterprise que comparten datos a nivel global. La versión 2026-09-14.2 añade una comprobación opcional de selfie con una referencia de CPF para Brasil. Las versiones anteriores mantienen su comportamiento original. Los perfiles actuales admiten riesgo de correo electrónico, riesgo de teléfono, riesgo de IP, validación de bases de datos aptas y el historial de la red privada de tu aplicación. La vinculación de identidad basada en selfie requiere la versión 2026-09-14.2. Si la seleccionas en versiones anteriores, se devuelve not_available_in_profile_version.

Identidad declarada y contexto

Coloca el correo electrónico, el teléfono y los identificadores gubernamentales en subject.identifiers. Los identificadores gubernamentales requieren su país emisor; también puede ser necesario indicar un emisor cuando los números solo son únicos dentro de una región. Coloca los nombres, la fecha de nacimiento, la nacionalidad y la dirección en subject.attributes. Son declaraciones que se comparan cuando una fuente seleccionada lo admite, no hechos verificados por el simple hecho de haberse enviado. Usa context para la dirección IP, el agente de usuario, la finalidad, el país del intento y cualquier declaración de consentimiento requerida. Así se separa la información sobre el intento de verificación de la información sobre la persona. Para las comprobaciones biométricas compatibles, proporciona subject.selfie como JPEG, PNG o WebP codificado en base64, de hasta 6 MB. También se acepta un URI de datos de la misma imagen. No envíes una imagen de referencia, una URL remota ni una clave de almacenamiento.

Selfie e identificador declarado

Selecciona biometric_identity, envía un identificador brasileño tax_number y una selfie, y confirma context.consent_obtained. La referencia comprueba si esa selfie pertenece al titular del CPF declarado. Si falta el consentimiento, se devuelve consent_required, y los países no admitidos devuelven unsupported_region. El módulo tiene un precio por comprobación basado en la tarifa de validación de base de datos de tu organización; revisa el plan antes de ejecutarlo. Cuando la referencia responde, identity_relationship.result es match, mismatch o inconclusive. Una respuesta no concluyente requiere revisión y nunca se trata como una falta de coincidencia. El resultado solo establece la relación entre la selfie y el CPF. No valida un nombre ni una fecha de nacimiento enviados, no realiza una prueba de vida ni busca un rostro en internet ni en la red global de fraude. Los nombres y la fecha de nacimiento siguen siendo declaraciones, salvo que otra fuente seleccionada aporte evidencia para esos campos. Los tiempos de espera agotados y los errores de la fuente son resultados no disponibles y no se facturan. Las respuestas no concluyentes completadas se facturan con la misma tarifa de comprobación de referencia. Esta comprobación no incluye la selfie en el resultado ni la almacena como contenido multimedia de la sesión.

Selecciona las comprobaciones

checks.include selecciona módulos, y checks.exclude tiene prioridad. Una lista include explícitamente vacía desactiva todo el trabajo opcional; la normalización se sigue ejecutando. Si omites include, se usan los valores predeterminados del perfil fijado. El enriquecimiento social de correo electrónico y de teléfono se selecciona por separado con email_social y phone_social. Requieren un identificador válido correspondiente y no envían un OTP.

Interpreta los resultados sin mezclarlos

Cada módulo informa de su estado de ejecución, su motivo y sus unidades facturables. not_requested, excluded_by_caller, missing_required_input y source_unavailable describen resultados distintos. Una fuente ausente no es una falta de coincidencia de identidad ni un resultado de riesgo cero. attribute_evidence describe la evidencia a nivel de campo, mientras que risk mantiene separadas las dimensiones de identidad, contacto, dispositivo, comportamiento y red de fraude. Un correo electrónico, un dispositivo u otro identificador compartido es una conexión observada, no una prueba de que dos cuentas pertenezcan a la misma persona ni de que hayan cometido fraude. recommendation es la recomendación de la comprobación; no cambia el estado de ningún otro registro. Los resultados del enriquecimiento social aparecen en enrichment, y los resultados no disponibles se distinguen de los completados.

Red global de fraude

Selecciona networks_cross_org para consultar en la red compartida los identificadores admitidos: correos electrónicos, teléfonos e identificadores de documento con el espacio de nombres correcto. La consulta requiere el plan Enterprise y que el modo de compartición de tu organización esté configurado en global. Si no se cumplen estos requisitos, el plan informa del módulo con available: false y availability_reason: "entitlement_required", y una comprobación que lo seleccione lo omite con el estado skipped y el motivo entitlement_required. El mismo motivo se aplica cuando Networks no está habilitado para tu organización. Las aplicaciones de sandbox no están limitadas por el plan ni por el modo de compartición: con un identificador admitido, el módulo se ejecuta y devuelve un resultado de ejemplo vacío. La consulta usa el presupuesto de lecturas existente de la organización y registra una auditoría de la lectura. No tiene ningún cargo por consulta. Planificar una comprobación no consulta el índice compartido ni consume su presupuesto de lecturas. network.cross_organization contiene signals_checked y los insights agregados divulgados cuando la comprobación se completa. Cada insight contiene el tipo de señal, las clases de resultado, el número de contribuyentes, la categoría de antigüedad y, solo cuando la divulgación está habilitada, las categorías de sector. Nunca identifica a otra organización, cuenta, persona o verificación. Los resultados por debajo del umbral de divulgación se omiten; una lista vacía no demuestra la ausencia de historial de fraude. Una señal compartida divulgada genera una recomendación de revisión, nunca un rechazo automático ni una coincidencia de identidad. Una consulta no disponible informa de su motivo por separado de una consulta completada sin resultados. Si más adelante tu organización pierde el acceso entre organizaciones, por ejemplo tras un cambio de plan o cuando la compartición deja de estar en global, la recuperación de resultados, los reintentos y los detalles de la sesión ocultan los agregados compartidos y la evidencia de riesgo derivada de ellos. La recomendación original se mantiene como decisión histórica; las lecturas no cambian el estado de la verificación.

Sesiones, reintentos y cargos

check_id recupera el resultado almacenado mediante Get a Fraud Check. Cuando está presente, request_id identifica su sesión de verificación nativa. Las versiones 2026-09-14, 2026-09-14.1 y 2026-09-14.2 siempre crean esa sesión, incluso cuando solo se selecciona el historial de la red privada. Reutilizar client_reference con el mismo cuerpo de solicitud devuelve el resultado original sin otra ejecución ni otro cargo mientras exista esa comprobación. Un cuerpo distinto con la misma referencia devuelve 409. Si la ejecución sigue en curso, reintenta la misma solicitud tras el intervalo indicado en Retry-After de la respuesta. Eliminar la verificación asociada también elimina el resultado de Fraud Check; a partir de entonces, la recuperación devuelve 404. Una comprobación eliminada durante la ejecución no puede publicar un resultado completado. Los precios proceden de las tarifas prepago o contractuales vigentes de tu organización. Los módulos no disponibles y omitidos no se facturan, y el historial de la red privada no tiene cargo por comprobación. Las comprobaciones en sandbox usan respuestas de ejemplo, sin llamadas a proveedores que generen cargos ni cargos.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

subject
object
requerido
client_reference
string

Tu propia referencia para esta comprobación. También sirve como clave de idempotencia: reutilizarla con el mismo cuerpo devuelve la comprobación original sin volver a ejecutar ni facturar los módulos; reutilizarla con un cuerpo distinto devuelve 409.

Required string length: 1 - 255
profile
string
predeterminado:standard

ID del perfil de orquestación. Por defecto, el perfil standard de Didit.

Required string length: 1 - 64
profile_version
string

Fija una versión congelada del perfil. De forma predeterminada, se usa la versión actual del perfil.

Required string length: 1 - 32
context
object
checks
object
vendor_data
string
Maximum string length: 1000
metadata
any

Respuesta

check_id
string<uuid>
requerido
client_reference
string | null
requerido
processing_status
enum<string>
requerido
  • pending - Pendiente
  • running - En ejecución
  • completed - Completado
  • failed - Fallido
Opciones disponibles:
pending,
running,
completed,
failed
profile_id
string
requerido
profile_version
string
requerido
created_at
string<date-time>
requerido
completed_at
string<date-time> | null
requerido
inputs
object[]
requerido
modules
object[]
requerido
attribute_evidence
object[]
requerido
compound_evidence
object[]
requerido
risk
object[]
requerido
network
object
requerido
recommendation
enum<string>
requerido
  • approve - Aprobar
  • review - Revisar
  • reject - Rechazar
Opciones disponibles:
approve,
review,
reject
next_action
enum<string>
requerido
  • none - Ninguna
  • manual_review - Revisión manual
  • step_up - Verificación adicional
  • resubmit_capture - Repetir captura
Opciones disponibles:
none,
manual_review,
step_up,
resubmit_capture
decision_reasons
string[]
requerido
coverage
object
requerido
usage
object[]
requerido
request_id
string<uuid>

Sesión de verificación nativa creada para esta comprobación.

enrichment
object
identity_relationship
object | null
vendor_data
string | null
metadata
unknown
Última modificación el 1 de noviembre de 2026