Manteca

Manteca Docs

Introducción

Autenticación

Finanzas

Obtener balance

Obtener deuda

Obtener crédito

Obtener reporte

Gestión de usuarios

Usuarios

Compliance

Mercado

Precios

Órdenes

Reglas de pago

Transacciones

Movimientos fiat

Movimientos cripto

Widget

Casos de uso

Parámetros en URL

Webhooks

Crear webhook

Obtener webhook

Eventos

Países soportados

Argentina

Chile

Colombia

Brasil

Flujos de API

Alta de usuario

On-ramp

Off-ramp

Assets de prueba

Fiat

Cripto

Paginación

Errores

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

<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>El API permite realizar operaciones tanto de cripto contra fiat como de cripto contra cripto. Para ejecutar una operación, se deben seguir los siguientes pasos:</p><p></p><div><div><div><h6>1</h6><h3>Consultar precio del par</h3><p>Obtené el precio actualizado del par de activos con el que deseas ope</p></div></div></div>

El API permite realizar operaciones tanto de cripto contra fiat como de cripto contra cripto. Para ejecutar una operación, se deben seguir los siguientes pasos:

<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>
El <strong>widget</strong> 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>Además, el sistema cuenta con </p>

 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, transacciones de compra o venta, entre otros.


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.


<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. 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 <code>md-webhook-signature</code> como header que, junto con el <code>secret</code> que tenemos en conjunto, permitirá realizar la verificaci</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. 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 

 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.

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 

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

Para utilizar la API en Chile, se extiende el funcionamiento para el flujo argentino, modificando o añadiendo los siguientes campos: 

John Smith

["Cuenta corriente", “Cuenta de ahorros”, “Cuenta Vista”]

Los pares disponibles para operar son aquellos que, 

Es similar al flujo que se realiza para Argentina, adecuándose el proceso de KYC, a la identificación de la identidad de las personas de Chile. En vez de ingresar un CUIT, se ingresa el RUT. También se añaden algunos datos adicionales de la cuenta bancaria. Estas son las pantallas que visualizará el usuario para el proceso de 

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

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.