Manteca

Getting Started

Introducción

Autenticación

Webhooks

Dashboard

Onboarding users

Widget

Getting users data

Usuarios

Compliance

Blank

API Onboarding

Seamlessly integrate user onboarding, identity verification, and KYC/AML checks into your platform with a single API

Docs - API Onboarding

Production

Sandbox

<p class="slate-p " ><strong class="slate-bold">API Onboarding</strong> está diseñada para empresas que buscan agilizar el proceso de onboarding de sus usuarios sin incurrir en costos elevados. A través de nuestro servicio, es posible realizar la validación de identidad y la generación de perfiles de usuario en cuestión de segundos, cumpliendo con las normativas vigentes.</p><p class="slate-p " >Nuestro servicio realiza las siguientes validaciones:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Validación de identidad: Verificación de vigencia del DNI y datos personales (Renaper).</div></li><li class="slate-li " ><div style="position:relative">Autenticidad del documento: Comprobación de la veracidad del DNI cargado.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Datos fiscales</strong>: Consulta en bases impositivas (ARCA).</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Antecedentes y restricciones</strong>: Revisión en listas de inhibiciones, DNI cuestionados, terrorismo, noticias adversas, Personas Expuestas Políticamente (PEP) y Sujetos Obligados (SO).</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Perfil socioeconómico</strong>: Cálculo de un scoring basado en los parámetros mencionados anteriormente.</div></li></ol><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ></h4><h3 class="slate-h3 " >Arquitectura y formato de respuesta</h3><p class="slate-p slate-indent-0" style="0px">Manteca está organizada alrededor de la interfaz <a href="https://en.wikipedia.org/wiki/REST" target="_self">REST</a>. Tiene URLs predecibles orientadas a recursos y usa códigos de respuesta HTTP estándar. Todos los valores de retorno son en formato JSON.</p><p class="slate-p slate-indent-0" style="0px">Contamos con un sandbox para que puedas probar el API sin alterar los flujos productivos. Para acceder al mismo, tendrás que usar la URL correspondiente (junto con sus API keys).</p><p class="slate-p slate-indent-0" style="0px">Por otro lado, para todo lo que es notificaciones hacia el lado del cliente, utilizamos webhooks. También contamos con un servicio de websockets para escuchar algunos eventos como los precios.</p><p class="slate-p slate-indent-0" style="0px">El API utiliza el protocolo <a href="https://en.wikipedia.org/wiki/HTTPS" target="_self">HTTPS</a> para exponer los endpoints. No soporta HTTP.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p><h3 class="slate-h3 " >Entorno de pruebas (sandbox)</h3><p class="slate-p " >Disponemos de un entorno sandbox para que puedas probar la API sin afectar los flujos productivos. Para acceder, es necesario utilizar la base URL https://sandbox.manteca.dev junto con las API keys entregadas.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p><h3 class="slate-h3 " >Notificaciones</h3><p class="slate-p slate-indent-0" style="0px">Como medio para las notificaciones utilizamos webhooks con exponential-backoff; es decir, que seguiremos enviando los avisos hasta que nos respondas con un estado 2xx. Para más información, ir a <a href="67cf0a0efa1385d3a3e90a86/67cf3661227ea3738dc2681c" target="">Webhooks</a>.<div class="slate-div"></div><div class="slate-div"></div></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

 está diseñada para empresas que buscan agilizar el proceso de onboarding de sus usuarios sin incurrir en costos elevados. A través de nuestro servicio, es posible realizar la validación de identidad y la generación de perfiles de usuario en cuestión de segundos, cumpliendo con las normativas vigentes.

Nuestro servicio realiza las siguientes validaciones:

Manteca está organizada alrededor de la interfaz 

. Tiene URLs predecibles orientadas a recursos y usa códigos de respuesta HTTP estándar. Todos los valores de retorno son en formato JSON.

Contamos con un sandbox para que puedas probar el API sin alterar los flujos productivos. Para acceder al mismo, tendrás que usar la URL correspondiente (junto con sus API keys).

Por otro lado, para todo lo que es notificaciones hacia el lado del cliente, utilizamos webhooks. También contamos con un servicio de websockets para escuchar algunos eventos como los precios.

 para exponer los endpoints. No soporta HTTP.

Disponemos de un entorno sandbox para que puedas probar la API sin afectar los flujos productivos. Para acceder, es necesario utilizar la base URL https://sandbox.manteca.dev junto con las API keys entregadas.

Como medio para las notificaciones utilizamos webhooks con exponential-backoff; es decir, que seguiremos enviando los avisos hasta que nos respondas con un estado 2xx. Para más información, ir a 

<p class="slate-p slate-indent-0" style="0px">Manteca utiliza <strong class="slate-bold">API keys</strong> para autenticar los requests. Las mismas son enviadas a través del header md-api-key</p><p class="slate-p slate-indent-0" style="0px">Las credenciales poseen privilegios completos por lo que es imprescindible que sean guardadas de manera segura. La interacción con Manteca debe ser siempre del lado del servidor, especialmente para los llamados autenticados.</p><p class="slate-p slate-indent-0" style="0px">En algunos casos, también proveemos la posibilidad de realizar IP whitelisting o acceder vía una VPN exclusiva para aumentar la seguridad.</p><p class="slate-p slate-indent-0" style="0px">
</p><p class="slate-p " ></p>

 para autenticar los requests. Las mismas son enviadas a través del header md-api-key

Las credenciales poseen privilegios completos por lo que es imprescindible que sean guardadas de manera segura. La interacción con Manteca debe ser siempre del lado del servidor, especialmente para los llamados autenticados.

En algunos casos, también proveemos la posibilidad de realizar IP whitelisting o acceder vía una VPN exclusiva para aumentar la seguridad.

<p class="slate-p slate-indent-0" style="0px">Podés configurar los webhook endpoints a través del API para ser notificado por cada uno de los eventos que ocurran y te sean de interés. Para garantizar la integridad de los datos enviados mediante webhooks, utilizamos un sistema de validación basado en HMAC. Cada webhook se envía con una firma en md-webhook-signature como header que, junto con el secret que tenemos en conjunto, permitirá realizar la verificación de autenticidad de los mensajes. Básicamente, el sigature enviado tiene que ser el mismo que generan de su lado, aplicando HMAC al contenido que llega con el secreto en común.</p><p class="slate-p slate-indent-0" style="0px">Para garantizar que la serialización del JSON sea determinística, es necesario ordenar las claves del objeto de manera alfabética antes de realizar la conversión a string. Esto asegura consistencia en las respuestas y es especialmente útil para firmas criptográficas o validaciones HMAC. En nuestro caso particular, utilizamos la librería fast-json-stable-stringify para hacer la serialización del mismo.</p><p class="slate-p slate-indent-0" style="0px">Los webhooks, tanto en el entorno de desarrollo como en el productivo, llegarán de la IP <a href="https://docs.manteca.dev/cripto/" target="_self">18.229.68.94</a>. La misma se encuentra fija para poder ajustar las políticas de seguridad pertinentes de su lado. Además, tenemos un sistema de reintentos automáticos que operan con exponential backoff; esto significa que se reintentará múltiples veces y cada reintento será después de un intervalo mayor. Realizamos hasta 8 reintentos de cada envío.</p><p class="slate-p " >Además, contamos con un sistema de reintentos automáticos con exponential backoff, lo que significa que:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Si un webhook no se recibe correctamente, el sistema intentará reenviarlo.</div></li><li class="slate-li " ><div style="position:relative">Cada reintento se realizará después de un intervalo de tiempo creciente.</div></li><li class="slate-li " ><div style="position:relative">Se realizarán hasta <strong class="slate-bold">8 intentos</strong> antes de descartar el mensaje.</div></li></ul><p class="slate-p " ></p>

Podés configurar los webhook endpoints a través del API para ser notificado por cada uno de los eventos que ocurran y te sean de interés. Para garantizar la integridad de los datos enviados mediante webhooks, utilizamos un sistema de validación basado en HMAC. Cada webhook se envía con una firma en md-webhook-signature como header que, junto con el secret que tenemos en conjunto, permitirá realizar la verificación de autenticidad de los mensajes. Básicamente, el sigature enviado tiene que ser el mismo que generan de su lado, aplicando HMAC al contenido que llega con el secreto en común.

Para garantizar que la serialización del JSON sea determinística, es necesario ordenar las claves del objeto de manera alfabética antes de realizar la conversión a string. Esto asegura consistencia en las respuestas y es especialmente útil para firmas criptográficas o validaciones HMAC. En nuestro caso particular, utilizamos la librería fast-json-stable-stringify para hacer la serialización del mismo.

Los webhooks, tanto en el entorno de desarrollo como en el productivo, llegarán de la IP 

. La misma se encuentra fija para poder ajustar las políticas de seguridad pertinentes de su lado. Además, tenemos un sistema de reintentos automáticos que operan con exponential backoff; esto significa que se reintentará múltiples veces y cada reintento será después de un intervalo mayor. Realizamos hasta 8 reintentos de cada envío.

Además, contamos con un sistema de reintentos automáticos con exponential backoff, lo que significa que:

<p class="slate-p " >El <strong class="slate-bold">Dashboard de KYC</strong> es una plataforma diseñada para proporcionar a las empresas que integran nuestro servicio de verificación de identidad (KYC) un acceso centralizado y seguro a la información de sus usuarios. A través de esta herramienta, es posible visualizar y gestionar los datos de los usuarios que han sido procesados mediante nuestra API de KYC, facilitando el control y la toma de decisiones en base a su estado y documentación.</p><h2 class="slate-h2 " ><strong class="slate-bold">Acceso y Seguridad</strong></h2><p class="slate-p " >El dashboard está disponible en los siguientes entornos:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Producción</strong>: <a href="https://dashboard.manteca.dev/login" target="_new">https://dashboard.manteca.dev/login</a></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">QA</strong>: <a href="https://dashboard-qa.manteca.dev/login" target="_new">https://dashboard-qa.manteca.dev/login</a></div></li></ul><p class="slate-p " >El acceso a la plataforma requiere autenticación mediante credenciales de usuario y cuenta con un <strong class="slate-bold">segundo factor de autenticación (2FA)</strong> para garantizar un nivel adicional de seguridad en el ingreso.</p><h2 class="slate-h2 " ><strong class="slate-bold">Funcionalidades Principales</strong></h2><h3 class="slate-h3 " ><strong class="slate-bold">1. Visualización de Datos del Usuario</strong></h3><p class="slate-p " >Cada usuario procesado a través del servicio de KYC es registrado en el dashboard, donde se pueden visualizar los siguientes datos clave:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Información personal:</strong> Nombre completo, fecha de nacimiento, género, nacionalidad, número de documento, dirección y otros datos relevantes.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Estado del usuario:</strong> Indica si el usuario está <strong class="slate-bold">activo</strong>, <strong class="slate-bold">pendiente de verificación</strong> o <strong class="slate-bold">rechazado</strong>.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Motivo del rechazo (si aplica):</strong> En caso de que el usuario haya sido rechazado, se muestra la razón específica del rechazo, como inconsistencias en los datos, documentación inválida o verificación fallida.</div></li></ul><h3 class="slate-h3 " ><strong class="slate-bold">2. Documentación Cargada</strong></h3><p class="slate-p " >Desde el dashboard se pueden visualizar los documentos que el usuario ha subido para su validación, incluyendo:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Foto del DNI o documento de identidad:</strong> Imagen del anverso y reverso del documento cargado.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Selfie o prueba de vida:</strong> Imagen del rostro del usuario utilizada en la validación biométrica.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Otros documentos requeridos (si aplica):</strong> Dependiendo del proceso KYC configurado, pueden solicitarse otros documentos adicionales.</div></li></ul><h3 class="slate-h3 " ><strong class="slate-bold">3. Gestión del Estado del Usuario</strong></h3><p class="slate-p " >El dashboard permite realizar acciones sobre los usuarios según su estado:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Aprobación manual:</strong> En casos donde se requiera una revisión manual, los operadores pueden aprobar un usuario directamente desde la plataforma.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Rechazo con motivo:</strong> Si un usuario no cumple con los requisitos, se puede registrar el rechazo y detallar la causa.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Solicitud de nueva documentación:</strong> Se puede solicitar al usuario que cargue nuevamente su documentación si esta no es legible o válida.</div></li></ul><h3 class="slate-h3 " ><strong class="slate-bold">4. Límites Operativos Sugeridos</strong></h3><p class="slate-p " >Para cada usuario aprobado, el dashboard muestra los límites operativos recomendados en base a su perfil y nivel de verificación. Estos pueden incluir:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Límite máximo de transacciones diarias y mensuales.</div></li><li class="slate-li " ><div style="position:relative">Restricciones en montos o tipos de operaciones.</div></li><li class="slate-li " ><div style="position:relative">Recomendaciones de nivel de riesgo según la validación realizada.</div></li></ul><h3 class="slate-h3 " ><strong class="slate-bold">5. Búsqueda y Filtros Avanzados</strong></h3><p class="slate-p " >El dashboard cuenta con herramientas avanzadas para la búsqueda y segmentación de usuarios, permitiendo filtrar por:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Estado del usuario (aprobado, pendiente, rechazado).</div></li><li class="slate-li " ><div style="position:relative">Fecha de registro o actualización.</div></li><li class="slate-li " ><div style="position:relative">Nombre o número de documento.</div></li><li class="slate-li " ><div style="position:relative">Motivo de rechazo o tipo de documento cargado.</div></li></ul><h3 class="slate-h3 " ><strong class="slate-bold">6. Auditoría y Registros de Actividad</strong></h3><p class="slate-p " >Todas las acciones realizadas en el dashboard quedan registradas en un log de auditoría, lo que permite un seguimiento detallado de las modificaciones y decisiones tomadas en la plataforma.</p><h2 class="slate-h2 " ><strong class="slate-bold">Conclusión</strong></h2><p class="slate-p " >El <strong class="slate-bold">Dashboard de KYC</strong> es una herramienta esencial para gestionar la validación de identidad de los usuarios de manera eficiente, segura y transparente. Con funcionalidades avanzadas de visualización, gestión y auditoría, proporciona un control total sobre el proceso KYC, permitiendo a las empresas garantizar el cumplimiento normativo y la seguridad en sus operaciones.</p><p class="slate-p " ></p>

 es una plataforma diseñada para proporcionar a las empresas que integran nuestro servicio de verificación de identidad (KYC) un acceso centralizado y seguro a la información de sus usuarios. A través de esta herramienta, es posible visualizar y gestionar los datos de los usuarios que han sido procesados mediante nuestra API de KYC, facilitando el control y la toma de decisiones en base a su estado y documentación.

El dashboard está disponible en los siguientes entornos:

El acceso a la plataforma requiere autenticación mediante credenciales de usuario y cuenta con un 

 para garantizar un nivel adicional de seguridad en el ingreso.

Cada usuario procesado a través del servicio de KYC es registrado en el dashboard, donde se pueden visualizar los siguientes datos clave:

Desde el dashboard se pueden visualizar los documentos que el usuario ha subido para su validación, incluyendo:

El dashboard permite realizar acciones sobre los usuarios según su estado:

Para cada usuario aprobado, el dashboard muestra los límites operativos recomendados en base a su perfil y nivel de verificación. Estos pueden incluir:

El dashboard cuenta con herramientas avanzadas para la búsqueda y segmentación de usuarios, permitiendo filtrar por:

Todas las acciones realizadas en el dashboard quedan registradas en un log de auditoría, lo que permite un seguimiento detallado de las modificaciones y decisiones tomadas en la plataforma.

 es una herramienta esencial para gestionar la validación de identidad de los usuarios de manera eficiente, segura y transparente. Con funcionalidades avanzadas de visualización, gestión y auditoría, proporciona un control total sobre el proceso KYC, permitiendo a las empresas garantizar el cumplimiento normativo y la seguridad en sus operaciones.

<p class="slate-p " >El widget es un sistema embebible diseñado para facilitar integraciones sin necesidad de desarrollo front-end. Este feature permite a las plataformas integrar procesos complejos como KYC, compra y venta de criptomonedas de forma trivial, adaptándose incluso a casos en los que normalmente no se requiere KYC en sus operaciones regulares. </p><p class="slate-p slate-indent-0" style="0px">Además, el sistema cuenta con<strong class="slate-bold"> webhooks configurables</strong> que notifican en tiempo real a la URL definida por la plataforma integradora cada vez que ocurre un evento de interés en el widget. Esto incluye eventos clave como la finalización del KYC.</p><p class="slate-p " >El widget sigue un funcionamiento estándar para todos los casos de uso. Los pasos principales son:</p><p class="slate-p " ></p><div class="steps-widget" style="width:100%;
  	min-width:100%;"><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >1</h6><h3 class="slate-h3 " >Generación de url</h3><p class="slate-p slate-indent-0" style="0px">Se realiza un POST a nuestras APIs con configuraciones específicas, para lograr el flujo esperado (onboarding, ramp-on, ramp-off). Entre estas configuraciones, se puede enviar un externalId que permitirá identificar al usuario posteriormente y un sessionId que permitirá conocer el historial de actividades que ocurrieron en una misma corrida.</p><p class="slate-p " ></p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >2</h6><h3 class="slate-h3 " >Redirección del usuario al widget</h3><p class="slate-p slate-indent-0" style="0px">Una vez tenemos la URL, se redirecciona allî al usuario, donde podrá seguir los pasos presentados de manera interactiva. Es importante destacar que el KYC se hace una única vez por usuario; es decir, si el mismo ya se encuentra registrado, el widget se da cuenta de manera automatica y evitar solicitarlo nuevamente.</p><p class="slate-p " ></p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >Redirección a la successUrl</h3><p class="slate-p slate-indent-0" style="0px">En cuanto el flujo termina, se redirigirá al usuario a la URL que fue configurada como successUrl; es decir, la url en caso de éxito. Si hubiera un error, el mismo sería informado vía esa URL o bien, se puede configurar para que se utilice una failureUrl.</p><p class="slate-p " ></p></div></div></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " >Flujo del registro</p><p class="slate-p " >Al acceder a la primera pantalla y completar los datos iniciales, la cuenta del usuario será creada. Luego, el usuario debe completar la información necesaria para verificar sus datos e identidad. Estos son todos los pasos que deberá seguir durante el proceso de creación de su cuenta, hasta que quede validado para operar.</p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/images-1711058861628.png" style="
              width:935px;
	            height:366px;
	            aspect-ratio:935 / 366"
         /></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Identificadores de usuario
</h3><p class="slate-p slate-indent-0" style="0px">Para identificar al usuario y a la operación de onboarding, contamos con distintos tipos de identificadores:</p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">externalId:</strong> Permite identificar al usuario posteriormente.</p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">sessionId:</strong> Facilita el seguimiento del historial de actividades dentro de una misma sesión.</p>

El widget es un sistema embebible diseñado para facilitar integraciones sin necesidad de desarrollo front-end. Este feature permite a las plataformas integrar procesos complejos como KYC, compra y venta de criptomonedas de forma trivial, adaptándose incluso a casos en los que normalmente no se requiere KYC en sus operaciones regulares. 

 que notifican en tiempo real a la URL definida por la plataforma integradora cada vez que ocurre un evento de interés en el widget. Esto incluye eventos clave como la finalización del KYC.

El widget sigue un funcionamiento estándar para todos los casos de uso. Los pasos principales son:

Al acceder a la primera pantalla y completar los datos iniciales, la cuenta del usuario será creada. Luego, el usuario debe completar la información necesaria para verificar sus datos e identidad. Estos son todos los pasos que deberá seguir durante el proceso de creación de su cuenta, hasta que quede validado para operar.

Para identificar al usuario y a la operación de onboarding, contamos con distintos tipos de identificadores:

 Permite identificar al usuario posteriormente.

 Facilita el seguimiento del historial de actividades dentro de una misma sesión.

<p class="slate-p " >Contamos también con APIs raw; es decir,</p><p class="slate-p " ></p>

Contamos también con APIs raw; es decir,

numberId

userId

email

cuit

country

civilState

name

creationTime

status

externalId

John Smit

Modelo

<p class="slate-p " >Un usuario es la unidad representativa de una persona en nuestros sistemas.</p><p class="slate-p " ><span style="color:rgb(0, 0, 0)">Para su identificación, recomendamos utilizar el </span><span style="color:rgb(0, 0, 0)"><code class="slate-code"><strong class="slate-bold">externalId</strong></code></span><span style="color:rgb(0, 0, 0)">, que es un identificador que el cliente puede determinar para poder reconocer posteriormente al usuario.</span></p><div class="slate-div"></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Un usuario es la unidad representativa de una persona en nuestros sistemas.

Para su identificación, recomendamos utilizar el 

, que es un identificador que el cliente puede determinar para poder reconocer posteriormente al usuario.

<p class="slate-p " >Para que un usuario pueda operar en la plataforma, es necesario que se encuentre en estado <strong class="slate-bold">ACTIVE</strong>. Este estado se alcanza al completar el proceso de <strong class="slate-bold">KYC</strong> y validar la documentación requerida. La validación se realiza automáticamente mediante sistemas internos, lo que garantiza un proceso rápido y prácticamente instantáneo.</p><p class="slate-p " >En algunos casos, si las imágenes no son claras, están incompletas o presentan inconsistencias, se requiere una validación manual, lo que puede tomar un poco más de tiempo.</p><p class="slate-p " ></p>

Para que un usuario pueda operar en la plataforma, es necesario que se encuentre en estado 

. Este estado se alcanza al completar el proceso de 

 y validar la documentación requerida. La validación se realiza automáticamente mediante sistemas internos, lo que garantiza un proceso rápido y prácticamente instantáneo.

En algunos casos, si las imágenes no son claras, están incompletas o presentan inconsistencias, se requiere una validación manual, lo que puede tomar un poco más de tiempo.

Sections