Gestiona personas físicas y morales desde la API
Crea, consulta y administra los expedientes de tus clientes desde la API y el panel.
Todas las verificaciones de un cliente, en un solo expediente.
Cada consulta queda registrada en el expediente con su folio y su fecha. El historial completo se recupera en una sola pasada, con la evidencia lista para una auditoría.
Dos tipos de persona, una sola API
Persona Física
Nombre, apellidos, sexo y fecha de nacimiento. El apellido materno, la CURP y el RFC son opcionales. Sobre el expediente corren las verificaciones, de la validación de CURP a la verificación de identidad.
Persona Moral
El expediente de una empresa se abre con la razón social y el nombre comercial. El RFC se valida ante el SAT con el RFC del expediente; los antecedentes judiciales y las listas de sanciones buscan los dos nombres en una sola consulta.
Qué guarda el expediente
Casi todos los campos son opcionales. El expediente se abre con los datos disponibles y el resto se agrega después. Unos campos guardan los datos de identidad que cotejan las verificaciones; otros, el contexto que registra tu equipo.
El identificador del expediente. Con él corres cada verificación y consultas el historial completo.
Ejemplo cus_lzk9m4ab3f9c2d1e
Campo de la API: id · stringIndica si el expediente es de una persona o de una empresa. Define los datos que se piden al alta y las verificaciones disponibles.
Ejemplo physical
Campo de la API: type · stringEl nombre de pila de la persona o, cuando el expediente es de una empresa, su nombre comercial.
Ejemplo María Fernanda
Campo de la API: name · stringComo aparecen en la identificación oficial. El apellido materno es opcional.
Ejemplo García Hernández
Campo de la API: last_name / mothers_last_nameEl nombre con el que la empresa está constituida. Con ella se abre el expediente de una persona moral.
Ejemplo Tech, S.A. de C.V.
Campo de la API: legal_name · string | nullSe captura en tres campos separados: día, mes y año.
Ejemplo 15 · 03 · 1990
Campo de la API: birth_day / birth_month / birth_yearEn el formato que usan los registros oficiales mexicanos.
Ejemplo M
Campo de la API: gender · string | nullEl país, con México por defecto, y la entidad federativa cuando el nacimiento fue en México. Un país distinto marca al cliente como extranjero.
Ejemplo MX · Ciudad de México
Campo de la API: birth_country / birth_placeLa clave única de población. Es opcional al alta y se puede agregar después. Habilita las verificaciones que dependen de ella.
Ejemplo GAHM900315MDFRRR05
Campo de la API: curp · string | nullEl registro fiscal de la persona o de la empresa. La confirmación ante el SAT lo toma del expediente.
Ejemplo GAHM900315AB1
Campo de la API: rfc · string | nullLa consulta de correo lo toma del expediente.
Ejemplo [email protected]
Campo de la API: datameta.email · string | nullLa consulta de teléfono lo toma del expediente.
Ejemplo +52 55 1234 5678
Campo de la API: datameta.phone · string | nullEl expediente guarda empresa, puesto, ciudad, estado, país, dirección y nacionalidad.
Ejemplo Grupo Torres · Compras
Campo de la API: datameta · objectEl resultado de la última validación ante RENAPO, con el documento oficial cuando se descargó. Indica si los datos capturados empataron con el registro.
Campo de la API: curp_validation · object | nullEl identificador que el cliente ya tiene en tu sistema. Queda guardado en el expediente y el buscador lo acepta igual que el folio.
Ejemplo crm-48213
Campo de la API: custom_id · string | nullLa marca que tu equipo asigna al expediente: bajo, medio o alto.
Ejemplo medium
Campo de la API: risk · string | nullCómo funciona
Abre el expediente
Envías los datos del cliente. El expediente queda abierto y regresa su folio.
Corre las verificaciones
Cada verificación corre sobre ese folio y su resultado queda registrado en el mismo expediente. El cotejo de CURP ante RENAPO se guarda ahí y la verificación de identidad lo reutiliza cuando el resultado fue exitoso.
Consulta el historial
El expediente regresa el perfil completo y la lista de todas las consultas corridas sobre esa persona.
Qué puedes correr sobre un expediente
Cada corrida se suma al historial del cliente con su folio y su fecha. Debajo de cada herramienta aparece lo que necesita para correr.
CURP contra RENAPO
Consulta ante RENAPO y cotejo con los datos que ya capturaste.
RFC ante el SAT
Confirma ante el SAT que el RFC está inscrito y a nombre de quién.
INE y Lista Nominal
Lee la credencial y confirma su vigencia en la Lista Nominal.
Verificación de identidad
Cotejo del documento contra la selfie del cliente, con prueba de vida.
Listas y sanciones
Coincidencias en listas públicas, con el detalle de cada una.
Antecedentes judiciales
Expedientes judiciales con el juzgado y las partes involucradas.
Teléfono
Validez, país, compañía telefónica y tipo de línea.
Correo
En qué plataformas está registrado ese correo.
Calificación de riesgo
Reúne en un solo número las señales de lo que ya corriste.
El historial de un cliente, consulta por consulta
Cada consulta aparece con la herramienta, el resultado, la fecha y su folio.
- Validación de CURP12 mar · 09:41
Los datos coinciden con RENAPO
Folio req_9c4b2ad17e
- Listas y sanciones12 mar · 09:42
Sin coincidencias
Folio req_1f7e0b93cc
- INE y Lista Nominal12 mar · 09:44
Credencial vigente
Folio req_5b30e7a2f1
- Verificación de identidad12 mar · 10:02
Selfie y documento cotejados
Folio req_77c1d4e6a9
Búsqueda con cualquier dato
Por nombre, por correo, por el folio del cliente o por el identificador que usa tu equipo. Los resultados regresan paginados.
Dos ambientes separados
La misma estructura corre en pruebas y en producción, con datos separados. El ambiente de pruebas no tiene costo.
Actualización del expediente
Un dato nuevo, como la CURP o un teléfono, se agrega al expediente que ya existe.
Dos catálogos, una ficha
El expediente guarda el identificador de tu sistema junto al folio de Singula. Los dos señalan la misma ficha.
Cómo se usa en la operación
Lo que define tu equipo y lo que registra el expediente.
Tu calendario de revisión
Las verificaciones corren cuando tu equipo las dispara, en el alta o en cada renovación de contrato. Tu equipo define a quién se revisa y con qué frecuencia; cada corrida queda registrada en el mismo expediente.
Consentimiento y privacidad
Siguen en tu propio flujo, con las reglas que ya acordó tu área legal, incluida la verificación de identidad. El expediente guarda qué se consultó y en qué fecha.
Etiqueta y calificación
El expediente guarda dos valores: la etiqueta que asigna tu equipo y la calificación de 0 a 100 calculada con las consultas ya corridas.
Extranjeros y empresas
Un cliente extranjero se da de alta igual que cualquier otro, con su país de nacimiento en el expediente. Personas físicas y morales comparten el mismo catálogo y el mismo buscador.
Todo se hace por API.
Cada operación de esta página corre como llamada a la API. La referencia completa, campo por campo, está en la documentación.
curl -X POST https://api.singula.mx/customer \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{ "name": "Maria", "last_name": "Garcia",
"mothers_last_name": "Rodriguez", "gender": "M",
"birth_day": "15", "birth_month": "03",
"birth_year": "1990", "env": "production" }'
→ {
"data": {
"id": "cus_lzk9m4ab3f9c2d1e",
"type": "physical",
"name": "Maria",
"last_name": "Garcia",
"env": "production"
}
}Preguntas frecuentes
Sí. El expediente guarda tu propio identificador junto al folio de Singula y el buscador acepta los dos. El folio lleva directo al expediente; cualquier otro texto busca por nombre o por correo.
Sí. La CURP y el RFC son opcionales. Abres el expediente con el nombre y la fecha de nacimiento. Cuando se agregan, las verificaciones que dependen de ellos quedan disponibles.
Sí, siempre que la haya corrido tu misma organización sobre esa CURP y con resultado exitoso. Al abrir el expediente indicas el folio de esa validación previa y queda ligada al historial del cliente.
Cada consulta corrida sobre esa persona, con la herramienta, el resultado, la fecha y su folio. El expediente regresa el historial junto con el perfil.
En el ambiente de pruebas, que trabaja con datos aislados y sin costo. Ahí corres el alta y todas las verificaciones. Al pasar a producción, los datos de pruebas se quedan en ese ambiente.
Abre el primer expediente
Crea la cuenta, prueba el alta y las verificaciones en el ambiente de pruebas, sin costo, y pasa a producción cuando tu área lo apruebe.
Crear cuenta gratuita