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 class="slate-p " ></p><p class="slate-p " >La sección de <strong class="slate-bold">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 class="slate-p " ></p><h3 class="slate-h3 " ><strong class="slate-bold">Operaciones disponibles</strong></h3><p class="slate-p " ></p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Depósitos y retiros de fiat</strong>: los usuarios pueden ingresar o retirar dinero fiat directamente desde y hacia cuentas bancarias vinculadas.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Depósitos y retiros de cripto</strong>: los usuarios pueden transferir criptomonedas desde wallets externas hacia la plataforma y viceversa. Los retiros son procesados hacia direcciones específicas en cadenas compatibles.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Órdenes contra fiat y otras criptomonedas</strong>: se pueden realizar operaciones de compra y venta tanto en pares cripto-fiat como cripto-cripto.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Reglas de pago: </strong>son cadenas de acciones preconfiguradas que se ejecutan automáticamente. Estas reglas permiten simplificar procesos complejos y garantizar que se cumplan pasos específicos en una transacción. Por ejemplo, solicitar una compra de criptomonedas y su posterior retiro a una dirección particular.</div></li></ol><p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " >Todas las operaciones se encuentran también disponibles en Sandbox, donde contamos con la posibilidad de acreditar fiat ficticio y usar criptomoendas exclusivamente minteadas por Manteca para este propósito. Para más información, ver <a href="670ebcb2e95692c18c8815c7" target="">assets de prueba</a>.</p></div></div><p class="slate-p " ></p><p class="slate-p " >

</p><p class="slate-p " ></p>

 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>Llamadas relacionadas a los precios de los assets de la plataforma</p><p></p>

Llamadas relacionadas a los precios de los assets de la plataforma

<p>Llamadas relacionadas a las órdenes de un usuario</p><p></p>

Llamadas relacionadas a las órdenes de un usuario

<p class="slate-p " >Llamadas relacionadas a los movimientos de dinero del usuario</p><p class="slate-p " ></p><p class="slate-p " ></p>

Llamadas relacionadas a los movimientos de dinero del usuario

<p class="slate-p " >Devuelve los depósitos asociados a la compañía. De manera opcional, se puede proporcionar el parámetro <code class="slate-code">userId</code> para obtener los depósitos asociados a un usuario en particular.</p><div class="slate-div"></div><p class="slate-p " ></p><div class="slate-div"></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Devuelve los depósitos asociados a la compañía. De manera opcional, se puede proporcionar el parámetro 

 para obtener los depósitos asociados a un usuario en particular.

Obtener depósitos

userId

startDate

endDate

totalCount

pageCount

pageSize

lastPage

data

<p class="slate-p " >Devuelve los retiros asociados a la compañía. De manera opcional, se puede proporcionar el parámetro <code class="slate-code">userId</code> para obtener los retiros asociados a un usuario en particular.</p><div class="slate-div"></div><p class="slate-p " ></p><div class="slate-div"></div><p class="slate-p " ></p><p class="slate-p " ></p>

Devuelve los retiros asociados a la compañía. De manera opcional, se puede proporcionar el parámetro 

 para obtener los retiros asociados a un usuario en particular.

Obtener retiros

<p class="slate-p" placeholder="Type / for widgets">Devuelve un retiro por su ID</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

Obtener retiro por ID

withdrawId

bankId

status

amount

numberId

coin

destAccount

creationTime

user

bank

<p class="slate-p" placeholder="Type / for widgets">Realiza un retiro a cierta cuenta bancaria asociada al usuario. El retiro, dependiendo del monto, puede ser particionado en dos. En este caso, vendrán dos retiros en el array de la respuesta y los retiros tendrán un nuevo parámetro llamado <code class="slate-code">linkedWithdrawId: {id de retiro asociado}</code> el cual asociará los retiros entre si.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

Realiza un retiro a cierta cuenta bancaria asociada al usuario. El retiro, dependiendo del monto, puede ser particionado en dos. En este caso, vendrán dos retiros en el array de la respuesta y los retiros tendrán un nuevo parámetro llamado 

linkedWithdrawId: {id de retiro asociado}

Hacer un retiro

CBU de la cuenta bancaria. Si el usuario no cuenta con la cuenta bancaria asociada, se le crea en el instante de hacer el retiro

<p>Llamadas relacionadas a las transacciones de criptomonedas entrantes y salientes de la plataforma</p><p></p><p></p>

Llamadas relacionadas a las transacciones de criptomonedas entrantes y salientes de la plataforma

<p></p><p>Las reglas de pago funcionan como una capa de abstracción sobre los diversos servicios involucrados en las operaciones de compra/venta y retiro de activos. Simplifican el proceso de <strong>ramp-on</strong> y <strong>ramp-off</strong> al unificar la lógica necesaria para manejar tanto criptomonedas como fiat de manera automática.</p><p>
El endpoint </p>

Las reglas de pago funcionan como una capa de abstracción sobre los diversos servicios involucrados en las operaciones de compra/venta y retiro de activos. Simplifican el proceso de 

 al unificar la lógica necesaria para manejar tanto criptomonedas como fiat de manera automática.

 se utiliza para realizar la compra automática de criptomonedas y el retiro de los fondos resultantes. Cuando se reciben los fondos (por ejemplo, en pesos argentinos), se genera automáticamente una orden de compra de la criptomoneda solicitada. Una vez completada la compra, los activos se retiran y transfieren a la dirección de criptomonedas especificada, a través de la red solicitada. 

 gestiona la venta de criptomonedas y el retiro de los fondos resultantes. Cuando se reciben los fondos (por ejemplo, USDC vía Ethereum), se genera automáticamente una orden de venta contra la moneda solicitada. Una vez completada la venta, los activos se retiran y transfieren a la cuenta bancaria solicitada.

<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 