Manteca

Manteca Docs

Introducción

Autenticación

Errores

Paginación

Finanzas

Obtener balance

Obtener deuda

Obtener crédito

Obtener reporte

Gestión de usuarios

Usuarios

Compliance

Transacciones

Precios

Órdenes

Movimientos fiat

Movimientos cripto

Reglas de pago

Widget

Casos de uso

Flujos de API

Alta de usuario

On-ramp

Off-ramp

Webhooks

Crear webhook

Obtener webhook

Países soportados

Argentina

Chile

Colombia

Brasil

Assets de prueba

Fiat

Criptomonedas

Health

Theneo Demo TechCrunch

API Cripto

Documentación - API Cripto

Producción

Sandbox

<p class="slate-p " ></p><p class="slate-p " >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 " >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 " >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 " >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><p class="slate-p " ></p><p class="slate-p " ></p>

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.

<p class="slate-p " ></p><p class="slate-p " >Manteca utiliza API keys para autenticar los requests. Las mismas son enviadas a través del header <code class="slate-code">md-api-key</code></p><p class="slate-p " >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 " >En algunos casos, también proveemos la posibilidad de realizar IP whitelisting o acceder vía una VPN exclusiva para aumentar la seguridad. </p>

Manteca utiliza API keys para autenticar los requests. Las mismas son enviadas a través del header 

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. 

md-api-key

internalStatus

message

errors

Ejemplo de respuesta de error

<p class="slate-p " >API Cripto usa <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" target="_self">respuestas HTTP</a> estándar para indicar resultados exitosos o fallidos. </p><p class="slate-p " >En general: </p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Códigos en el rango de <code class="slate-code">2xx</code> indican éxito.</div></li><li class="slate-li " ><div style="position:relative">Códigos en el rango de <code class="slate-code">4xx</code> indican un error relacionado a la información provista (como parámetros omitidos o con un tipo inválido).</div></li><li class="slate-li " ><div style="position:relative">Códigos en el rango de <code class="slate-code">5xx</code> indican un error inesperado en Manteca.</div></li></ul><p class="slate-p " >Más allá de los códigos, en caso de error, se podrá acceder a más detalle a partir de visualizar el body de la respuesta. Siempre se maneja un mismo formato que contiene por un lado un internalStatus que hace referencia a un código verbal de error y por otro, un message que es básicamente una descripción algo más detallada del error.</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><p class="slate-p " ><div class="slate-div"></div></p><p class="slate-p " ></p><p class="slate-p " ></p>

 estándar para indicar resultados exitosos o fallidos. 

Más allá de los códigos, en caso de error, se podrá acceder a más detalle a partir de visualizar el body de la respuesta. Siempre se maneja un mismo formato que contiene por un lado un internalStatus que hace referencia a un código verbal de error y por otro, un message que es básicamente una descripción algo más detallada del error.

Los parámetros enviados pueden tener algún problema. Normalmente, se indica el detalle en la respuesta.

Faltan las API keys o faltan permisos para acceder al recurso.

401, 403

Normalmente, ocurre cuando se envía el mismo requests repetidas veces en un corto lapso de tiempo.

Demasiadas requests enviadas en un corto período de tiempo.

<p class="slate-p " ></p><h3 class="slate-h3 " >Parámetros</h3><p class="slate-p " ></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><code class="slate-code">page</code>: Página actual, el default es 1.</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">limit</code>: La cantidad de elementos por página, el default es 10.</div></li></ul><div class="slate-div"></div><p class="slate-p " ></p>

page

limit

<p>La sección de finanzas permite gestionar y entender cómo se operan los fondos dentro de la plataforma. En este contexto, existen tres formas de operar:</p><ol><li><div><strong>Siempre en descubierto: </strong>en este modelo, los usuarios pueden operar sin necesidad de tener fondos disponibles en su balance. Cada vez que un usuario realiza una operación, se genera automáticamente un débito en s</div></li></ol>

La sección de finanzas permite gestionar y entender cómo se operan los fondos dentro de la plataforma. En este contexto, existen tres formas de operar:

Cuando se habilita la posibilidad de operar en descubierto, la compañía usuaria de Manteca asume la responsabilidad de cubrir los montos correspondientes a las operaciones realizadas. Esto implica enviar los fondos necesarios al 

 asignada, dentro del plazo temporal acordado entre las partes. El proceso de liquidación se realiza de forma automática, garantizando que las operaciones sean consistentes y transparentes.

<p></p><p>La <strong>gestión de usuarios</strong> es un componente clave en nuestro sistema, ya que la unidad base de todas las operaciones son los usuarios. Para realizar cualquier tipo de operación dentro de la plataforma, es obligatorio registrar a los usuarios y asegurarse de que se encuentren validados correctamente.</p><p>El proceso de validación incluye los siguientes pasos esenciales:</p><p></p>

 es un componente clave en nuestro sistema, ya que la unidad base de todas las operaciones son los usuarios. Para realizar cualquier tipo de operación dentro de la plataforma, es obligatorio registrar a los usuarios y asegurarse de que se encuentren validados correctamente.

El proceso de validación incluye los siguientes pasos esenciales:

<p></p><p>La sección de <strong>transacciones</strong> abarca todas las operaciones financieras que se pueden realizar dentro de la plataforma. Estas incluyen tanto movimientos de fondos como la ejecución de órdenes. A continuación, se describen las principales funcionalidades:</p><p></p><h3><strong>Operaciones disponibles</strong></h3><p></p><ol></ol>

 abarca todas las operaciones financieras que se pueden realizar dentro de la plataforma. Estas incluyen tanto movimientos de fondos como la ejecución de órdenes. A continuación, se describen las principales funcionalidades:

<p>La integración vía widget permite realizar el <strong>onboarding </strong>de usuarios e integrarse al proceso de <strong>onramp </strong>y de <strong>offramp </strong>directamente sin necesidad de desarrollo de front-end.</p><p></p><h3><strong>Funcionamiento</strong></h3>

La integración vía widget permite realizar el 

directamente sin necesidad de desarrollo de front-end.

El funcionamiento general es igual para todos los casos de uso. En esencia, lo que hay que hacer es generar una widget-URL a través de un POST a nuestras APIs con ciertas configuraciones (entre otras cosas, se elige qué flujo queremos realizar entre onboarding, ramp-on y ramp-off). Cada cliente es identificado a través del 

, lo que permite generar múltiples URLs para un mismo usuario en cualquier momento. Una vez obtenemos tal URL, bastaría con redirigir al usuario a la misma para iniciar el proceso.

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.


Vía chat, los usuarios recibirán atención personalizada para poder llevar a cabo el registro, si es que en algún momento tienen alguna duda, que no les permite finalizar el proceso. 

Luego de subir el documento, se realiza una lectura automática del DNI. En caso de que la imagen sea procesada correctamente, ya queda validada la cuenta. Caso contrario, se procede a una validación manual, para verificar que los datos son visibles y nítidos.

Parámetros que se devuelven en el returnUrl y failureUrl

Title

Description

<p>Descubrí algunas de las distintas soluciones que se pueden implementar a través del API Cripto. Acá vas a poder encontrar flujos y casos prácticos de uso de la plataforma.</p><p></p><p></p>

Descubrí algunas de las distintas soluciones que se pueden implementar a través del API Cripto. Acá vas a poder encontrar flujos y casos prácticos de uso de la plataforma.

<p>Podes 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.
</p><h3>¿Cómo funciona?</h3><p>A través del atributo secret, que se creó con el método POST, creamos un HMAC por medio del body y enviamos el webhook con toda la información. De esta manera, recibirás en el header el HMAC que creamos y la información en el body. Harás el mismo proceso, para verificar la</p>

Podes 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.


A través del atributo secret, que se creó con el método POST, creamos un HMAC por medio del body y enviamos el webhook con toda la información. De esta manera, recibirás en el header el HMAC que creamos y la información en el body. Harás el mismo proceso, para verificar la información.Cuando recibís el webhook, tomas la firma, el body y el secret que tenes almacenado. Luego, creas un HMAC y comparas con el que recibiste en el header, teniendo que obtener el mismo resultado. De esta manera, confirmamos que la información no ha sido adulterada. Para esto, se debe hacer un stringify que sortee el JSON alfabeticamente. Recomendamos la libreria 