Manteca

Manteca Docs

Introducción

Autenticación

Errores

Paginación

Webhooks

Configuración

Ejemplos

Recursos principales

Compañía

Contabilidad

Onboarding

Compliance

Usuarios

Balances

Bancos

Órdenes

Sintéticos

Precios

Dividendos

Flujos de API

Alta de usuario

Operación de dólar MEP

Health

Theneo Demo TechCrunch

API Broker

Documentación - API Broker

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 exponenr 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 exponenr 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 ciertas implementaciones donde lo creemos conveniente, también realizamos IP whitelisting para aumentar la seguridad. </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>

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 ciertas implementaciones donde lo creemos conveniente, también realizamos IP whitelisting para aumentar la seguridad. 

md-api-key

internalStatus

message

Ejemplo de respuesta de error

<p class="slate-p" placeholder="Type / for widgets">API Broker usa <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" target="_blank">respuestas HTTP</a> estándar para indicar resultados exitosos o fallidos. </p><p class="slate-p" placeholder="Type / for widgets">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" placeholder="Type / for widgets">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><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><p class="slate-p" placeholder="Type / for widgets"><div class="slate-mention_input"></div></p><p class="slate-p" placeholder="Type / for widgets"></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.

200 - OK

La creación de un recurso funcionó correctamente.

201 - Created

Todo funcionó correctamente y no hay response.

204 - No Content

El request tiene algún error. Por lo general, son conflictos con los parámetros enviados.

400 - Bad request

401 - Unauthorized

El API key no tiene suficientes permisos para realizar tal acción.

403 - Forbidden

404 - Not Found

La request genera un conflicto. Por ejemplo, por temas de duplicación de request.

409 - Conflict

La cantidad de requests enviados supera el límite impuesto.

429 - Too Many Requests

500 - Internal Server Error

<p class="slate-p" placeholder="Type / for widgets">Hay endpoints que devuelven arrays como response al pedido. En los casos en los que los datos pueden crecer dinámicamente, se devolverá la información de la paginación en el pedido y se aceptarán los siguientes parámetros para pedir los datos paginados.</p><h3 class="slate-h3">Parámetros</h3><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><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

Hay endpoints que devuelven arrays como response al pedido. En los casos en los que los datos pueden crecer dinámicamente, se devolverá la información de la paginación en el pedido y se aceptarán los siguientes parámetros para pedir los datos paginados.

page

limit

<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. Esto te permite recibir información en tiempo real sobre las operaciones que son relevantes para tu sistema.</p><p>Entre ellos, encontrarás notificaciones relacionadas a cambios de estado de órdenes, sintéticos, depósitos y retiros.</p><p>Es importante destacar que para validar la autenticidad de tales m</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. Esto te permite recibir información en tiempo real sobre las operaciones que son relevantes para tu sistema.

Entre ellos, encontrarás notificaciones relacionadas a cambios de estado de órdenes, sintéticos, depósitos y retiros.

Es importante destacar que para validar la autenticidad de tales mensajes, los firmamos mediante el uso de HMAC con el secreto compartido. Tal firma la podrán obtener del header md-webhook-signature.


<p>Existen dos tipos de compañía. PARTIALLY_MANAGED y FULLY_MANAGED. </p><h3>FULLY_MANAGED</h3><p>En este tipo la empresa no llevará un registro de los saldos de sus clientes ni de las operaciones bancarias, y no se permite deuda. El saldo final del usuario será 100% el saldo en Manteca. Las órdenes siempre utilizarán el saldo del cliente, sin generar deuda. Para ingresar saldos a la plataforma el cliente debe hacer un depósito y para retira</p>

Existen dos tipos de compañía. PARTIALLY_MANAGED y FULLY_MANAGED. 

En este tipo la empresa no llevará un registro de los saldos de sus clientes ni de las operaciones bancarias, y no se permite deuda. El saldo final del usuario será 100% el saldo en Manteca. Las órdenes siempre utilizarán el saldo del cliente, sin generar deuda. Para ingresar saldos a la plataforma el cliente debe hacer un depósito y para retirar saldos el cliente debe hacer un retiro. Las ganancias se registran como un crédito especial que debe liquidarse por Manteca en un intervalo de tiempo específico acordado con la empresa.

Este tipo está diseñado pensando en los 

. La empresa llevará un registro de al menos uno de los fiat (ARS, USD o ambos), y las operaciones se realizarán contra la deuda. La empresa gestiona el saldo de la moneda(s) asociadas. Manteca, por su parte, se encargará de gestionar el balance de la moneda no gestionada por la empresa, así como los activos de mercado asociados. Las órdenes contra la moneda manejada por la empresa siempre generarán deuda, sin utilizar el saldo del cliente. El resultado de la orden siempre aumentará el saldo del cliente, sin generar crédito. En caso de que sea la moneda manejada ésta se retira automáticamente apenas el mercado lo permita. Los depósitos de la moneda manejada siempre generarán crédito, sin aumentar el saldo del cliente. Se prohíben los retiros fiat de la moneda manejada y se realizan automáticamente al final del día, utilizando el saldo del cliente, sin generar deuda. Se permiten los retiros de las monedas no manejadas, utilizando el saldo del cliente, sin generar deuda. Las ganancias se registran como un crédito especial que debe liquidarse por Manteca en un intervalo de tiempo específico acordado con la empresa. 

Se puede llegar a requerir una inversión inicial que consideramos reserva para proveer liquidez. La empresa tendrá un límite determinado en dólares que indicará cuánta deuda puede llegar a tener en el momento. Para aumentar el límite se puede otorgar más reservas de antemano. Cada cierto período se realizarán dos tipos de 

, donde Manteca enviará las ganancias a la compañía. El segundo,

 de la empresa o Manteca y dejar registro del total operado durante ese ciclo. De ser necesario se harán transferencias entre la empresa y Manteca. La frecuencia de ambos 

son independientes, pueden ocurrir en plazos determinados arbitrariamente.

<p>Para altas de un cliente, Manteca asume que el email del cliente está verificado. El cliente se compone por dos módulos, la <strong>persona </strong>y el <strong>usuario</strong>.</p><h3>Usuario</h3><p>El usuario es la cuenta del cliente para la compañía. Se identifica con su número de cuenta (<strong>numberId</strong>). </p><h3>Persona</h3><p>Co</p>

Para altas de un cliente, Manteca asume que el email del cliente está verificado. El cliente se compone por dos módulos, la 

El usuario es la cuenta del cliente para la compañía. Se identifica con su número de cuenta (

Contiene los datos personales del cliente que se comparten entre todas las compañías. Esto permite que un cliente puede pertenecer a dos o más compañías sin conflicto. Se identifica con su número de ID nacional (

Al dar de alta un cliente, la empresa otorgará los datos de la pesona del mismo. Si el individuo tuviese una persona registrada, se comparará los datos nuevos recibidos con los datos existentes. Si existe una diferencia entre los datos, se generará un 

. En este paso, se requiere intervención de un administrador de Manteca, el cual actualizará la persona con los datos más recientes. 

Empieza el alta con el endpoint de Onboarding inicial. Recibe email, legalId, personalData (datos personales simplificados, no todo. El resto se intentará obtener directamente de servicios de información como AFIP) e información de bancos. En la response, en caso de obtener la flag de 

 se debe esperar a que un administrador lo resuelva.

Se debe ver el status del usuario creado. Dependiendo del status del usuario, faltará cierta información:

Obtener usuarios

numberId

legalId

email

Estado del usuario. Pueder ser alguno entre NEW, EMAIL_VALIDATED, VALIDATING, VALIDATION_FAILED, VALIDATED, ONBOARDING_FAILED, ACTIVE, INACTIVE y BLOCKED.

status

partialEmail

partialNumberId

partialLegalId

totalCount

pageCount

pageSize

lastPage

data

Obtener usuario por ID

userId

companyId

type

banking

creationTime

updatedAt

Borrar usuario por ID

Modificar usuario por ID

Agregar cuenta bancaria

bankAccount

currency

description

bank

virtual

Eliminar cuenta bancaria

<h3>Posibles estados</h3><div><table><div><div>Title</div><div>Description</div></div><colgroup><col></col><col></col></colgroup><tbody><tr></tr></tbody></table></div>

Title

Description

Una órden puede tener distintos tiempos de liquidación y, por tanto, de acreditación. 

El resultado de la misma va a estar disponible una vez terminado dicho tiempo de acreditación.

Las comisiones que se cobran para una orden son:

Una órden puede completarse parcialmente o en su totalidad. 

Nota: pueden haber órdenes canceladas o fallidas que tengan filledAmount mayor a cero.

<p>Un sintético es una automatización de múltiples órdenes de mercado. Las etapas del sintético se ejecutan los días hábiles a partir de las 12:00hs. Actualmente contamos con el siguiente tipo:  </p><ul><li><div>DOLAR_MEP: Consiste en una compra de un activo del mercado seguido de una espera por regulaciones (para la compra). Luego se realiza una venta de ese activo del mercado contra la moneda fiat esperada. La co</div></li></ul>

Un sintético es una automatización de múltiples órdenes de mercado. Las etapas del sintético se ejecutan los días hábiles a partir de las 12:00hs. Actualmente contamos con el siguiente tipo:  

<p>Un dividendo es un pago que una empresa hace a sus accionistas, distribuyendo parte de sus ganancias, generalmente en efectivo o acciones.</p><p></p><h3>Estados</h3><p>Los dividendos puede tener diferentes estados dependiendo la etapa de procesamiento en la cual se encuentra.</p><ul><li><div>PENDING ➜ Creado, pero aún debe ser procesado</div></li></ul>

Un dividendo es un pago que una empresa hace a sus accionistas, distribuyendo parte de sus ganancias, generalmente en efectivo o acciones.

Los dividendos puede tener diferentes estados dependiendo la etapa de procesamiento en la cual se encuentra.

Existe diferente tipos de dividendo dependiente el asset que lo genere.