Manteca

Estado del servicio (copy)

Introducción

Nuestra API

Autenticación

Dashboard

Conceptos clave

Personas, no usuarios

Límites operativos

Manejo de errores

Paginación

Configuración de empresa

Tu empresa

Comisiones

Contabilidad

Webhooks

Primeros pasos

Alta de usuario

Operaciones

Entidades

Usuarios

Personas

Balances

Depósitos

Retiros

Órdenes

Sintéticos

Queries comunes

Anexo

Manejo de límites

Obtener límites operativos

Aumentar límites operativos

Obtener precios

Obtener boleto de operación

Estado del servicio

Obtener estado del mercado

Theneo Demo TechCrunch

API Cambio

Documentación - API Cambio

Producción

Sandbox

<p class="slate-p " >Podés consultar el estado del servicio haciendo un llamado a nuestro endpoint de salud: </p>

Podés consultar el estado del servicio haciendo un llamado a nuestro endpoint de salud: 

<p class="slate-p slate-indent-0" style="0px">API Cambio está diseñada para acceder de forma simple y programática al mercado de dólar oficial, ya sea mediante operaciones directas o a través de un motor de liquidez con lógica de orderbook. </p><p class="slate-p slate-indent-0" style="0px">Ofrecemos una solución simple, robusta y adaptable al contexto regulatorio actual, permitiendo operar de manera confiable sin fricciones innecesarias.</p><p class="slate-p slate-indent-0" style="0px"></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Arquitectura y formato de respuesta</h3><p class="slate-p slate-indent-0" style="0px">Manteca está construida sobre una arquitectura RESTful, con endpoints organizados por recursos y URLs predecibles. Utiliza códigos de respuesta HTTP estándar, y todos los payloads de entrada y salida están formateados en <code class="slate-code">JSON</code>.

Proveemos un entorno sandbox que permite testear integraciones de forma segura, sin afectar el entorno productivo. Para utilizarlo, debés apuntar a la URL correspondiente del sandbox y autenticarte con las API keys asignadas para ese entorno.

Todos los endpoints se exponen exclusivamente sobre <code class="slate-code">HTTPS</code>.

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

API Cambio está diseñada para acceder de forma simple y programática al mercado de dólar oficial, ya sea mediante operaciones directas o a través de un motor de liquidez con lógica de orderbook. 

Ofrecemos una solución simple, robusta y adaptable al contexto regulatorio actual, permitiendo operar de manera confiable sin fricciones innecesarias.

Manteca está construida sobre una arquitectura RESTful, con endpoints organizados por recursos y URLs predecibles. Utiliza códigos de respuesta HTTP estándar, y todos los payloads de entrada y salida están formateados en 

.

Proveemos un entorno sandbox que permite testear integraciones de forma segura, sin afectar el entorno productivo. Para utilizarlo, debés apuntar a la URL correspondiente del sandbox y autenticarte con las API keys asignadas para ese entorno.

Todos los endpoints se exponen exclusivamente sobre 

<p class="slate-p " >Manteca utiliza API keys para autenticar los requests. Las mismas deben ser 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 almacenadas de manera segura. Es requerido realizar una rotación de las credenciales cada 12 meses. En caso contrario, los llamados al API fallarán.</p><p class="slate-p slate-indent-0" style="0px">Podemos habilitar medidas de control de red para entornos con requisitos especiales:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">IP whitelisting</div></li><li class="slate-li " ><div style="position:relative">Acceso vía VPN</div></li></ul><p class="slate-p " ></p>

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

Las credenciales poseen privilegios completos por lo que es imprescindible que sean almacenadas de manera segura. Es requerido realizar una rotación de las credenciales cada 12 meses. En caso contrario, los llamados al API fallarán.

Podemos habilitar medidas de control de red para entornos con requisitos especiales:

<p class="slate-p slate-indent-0" style="0px">El Dashboard es una interfaz centralizada que permite a las empresas monitorear y gestionar los procesos integrados a través de nuestra API. Desde esta plataforma, es posible visualizar el estado de los usuarios, analizar la documentación cargada y monitorear las operaciones en tiempo real.</p><p class="slate-p slate-indent-0" style="0px">Para acceder, bastaría con dirigirse a:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Entorno productivo: <a href="https://dashboard.manteca.dev/login" target="_new">https://dashboard.manteca.dev</a></div></li><li class="slate-li " ><div style="position:relative">Entorno sandbox: <a href="https://dashboard-qa.manteca.dev/login" target="_new">https://dashboard-qa.manteca.dev</a></div></li></ul><p class="slate-p slate-indent-0" style="0px">El acceso a la plataforma requiere autenticación mediante credenciales de usuario y cuenta con un segundo factor de autenticación (2FA) para garantizar un nivel adicional de seguridad en el ingreso.

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

El Dashboard es una interfaz centralizada que permite a las empresas monitorear y gestionar los procesos integrados a través de nuestra API. Desde esta plataforma, es posible visualizar el estado de los usuarios, analizar la documentación cargada y monitorear las operaciones en tiempo real.

El acceso a la plataforma requiere autenticación mediante credenciales de usuario y cuenta con un segundo factor de autenticación (2FA) para garantizar un nivel adicional de seguridad en el ingreso.



<p class="slate-p slate-indent-0" style="0px">Nuestro sistema de compliance hace seguimiento a la actividad de una persona, y no únicamente al usuario puntual que está operando. Esto significa que si una misma persona crea dos usuarios distintos bajo dos empresas diferentes que usan nuestro sistema, esos dos usuarios compartirán los mismos límites operativos.</p><p class="slate-p slate-indent-0" style="0px">Por ejemplo, si una persona alcanza su límite operando desde una cuenta en la Empresa A, no podrá seguir operando desde otra cuenta en la Empresa B. Lo mismo aplica para los bloqueos por actividad fraudulenta: el bloqueo se aplica a la persona, sin importar desde qué usuario o empresa se detectó el comportamiento.</p><p class="slate-p slate-indent-0" style="0px">En resumen, los límites y restricciones se aplican a nivel persona, sin importar cuántos usuarios o cuentas tenga distribuidos en distintas entidades.</p><p class="slate-p " ></p>

Nuestro sistema de compliance hace seguimiento a la actividad de una persona, y no únicamente al usuario puntual que está operando. Esto significa que si una misma persona crea dos usuarios distintos bajo dos empresas diferentes que usan nuestro sistema, esos dos usuarios compartirán los mismos límites operativos.

Por ejemplo, si una persona alcanza su límite operando desde una cuenta en la Empresa A, no podrá seguir operando desde otra cuenta en la Empresa B. Lo mismo aplica para los bloqueos por actividad fraudulenta: el bloqueo se aplica a la persona, sin importar desde qué usuario o empresa se detectó el comportamiento.

En resumen, los límites y restricciones se aplican a nivel persona, sin importar cuántos usuarios o cuentas tenga distribuidos en distintas entidades.

<p class="slate-p slate-indent-0" style="0px">Las personas cuentan con límites operativos definidos en el proceso de onboarding.</p><p class="slate-p slate-indent-0" style="0px">Estos límites son creados en base a un análisis de perfil económico de la persona usando información recabada de organismos públicos.</p><p class="slate-p slate-indent-0" style="0px">Se pueden considerar 2 categorías:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Límites mensuales</div></li><li class="slate-li " ><div style="position:relative">Límites anuales</div></li></ul><p class="slate-p " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " >¿Como funcionan los límites?</h4><p class="slate-p " >Los límites tanto el operativo como el mensual tienen un monto total y un monto disponible ( resultante de la cuenta total - operado ). Los límites contabilizan operación y depósito por separado. Cada persona solo puede depositar anualmente el monto indicado en el límite. Para consultarlos, utilizar <a href="6801c59912ef13c359751f46/68017cab31a80699b00ceaca" target="">Obtener límites operativos</a>.</p><h4 class="slate-h4 " >
¿Cómo elevar los límites operativos?</h4><p class="slate-p " >Lós limites se pueden aumentar a través de <a href="6801c59912ef13c359751f46/67ff336489d058832e7189ba" target="">Aumentar límites operativos</a>.</p><p class="slate-p " >Documentos aceptados:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Recibo de sueldo.</div></li><li class="slate-li " ><div style="position:relative">Facturas (en caso de ser montos pequeños, subir varias).</div></li><li class="slate-li " ><div style="position:relative">Declaración Jurada (ganancia o bienes personales).</div></li><li class="slate-li " ><div style="position:relative">Venta de titulos o propiedades, además de alguna de las anteriores.</div></li></ul><p class="slate-p " ></p>

Las personas cuentan con límites operativos definidos en el proceso de onboarding.

Estos límites son creados en base a un análisis de perfil económico de la persona usando información recabada de organismos públicos.

Los límites tanto el operativo como el mensual tienen un monto total y un monto disponible ( resultante de la cuenta total - operado ). Los límites contabilizan operación y depósito por separado. Cada persona solo puede depositar anualmente el monto indicado en el límite. Para consultarlos, utilizar 

Lós limites se pueden aumentar a través de 

internalStatus

message

errors

Ejemplo de respuesta de error

<p class="slate-p " >API Cambio 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.

API Cambio usa respuestas HTTP estándar para indicar resultados exitosos o fallidos. En general: Códigos en el rango de 2xx indican éxito.Códigos en e

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 usuario no tiene permitido realizar dicha acción.

403 - Forbidden

404 - Not Found

409 - Conflict

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

429 - Too Many Requests

500 - Internal Server Error

<p class="slate-p slate-indent-0" style="0px">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><div class="slate-div"></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></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.


<p class="slate-p slate-indent-0" style="0px">El primer paso para comenzar a utilizar nuestra API es crear la cuenta de empresa. Para ello, tenés que escribirnos a info@manteca.dev, donde vamos a revisar los requisitos de tu compañía y acompañarte durante el proceso de integración.</p><p class="slate-p slate-indent-0" style="0px">Durante el onboarding, vamos a crear tu entidad empresa y te entregaremos las API Keys necesarias para acceder a nuestro entorno sandbox, donde podrás realizar pruebas de integración.</p><p class="slate-p slate-indent-0" style="0px">Esta entidad incluirá todas las configuraciones relevantes, entre ellas:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Configuración contable: define qué direcciones están habilitadas para cancelar deudas y/o recibir ganancias</div></li><li class="slate-li " ><div style="position:relative">Configuración de webhooks: permite configurar cómo querés que tu empresa reciba las notificaciones de eventos del sistema.</div></li><li class="slate-li " ><div style="position:relative">Configuración de comisiones: permite configurar las comisiones que se cobrarán por encima del precio base.</div></li></ul><p class="slate-p " ></p>

El primer paso para comenzar a utilizar nuestra API es crear la cuenta de empresa. Para ello, tenés que escribirnos a info@manteca.dev, donde vamos a revisar los requisitos de tu compañía y acompañarte durante el proceso de integración.

Durante el onboarding, vamos a crear tu entidad empresa y te entregaremos las API Keys necesarias para acceder a nuestro entorno sandbox, donde podrás realizar pruebas de integración.

Esta entidad incluirá todas las configuraciones relevantes, entre ellas:

<p class="slate-p slate-indent-0" style="0px">En nuestro esquema, los precios que proveemos ya incluyen un spread que contempla nuestra ganancia, por lo tanto, pueden ser utilizados directamente en la operatoria sin necesidad de ajustes adicionales. Si tu empresa desea aplicar un fee adicional a los usuarios finales, este se debe configurar por encima de nuestros precios base. Cualquier monto adicional cobrado será considerado ganancia de la empresa y podrá ser gestionado y monitoreado desde nuestro sistema de contabilidad.</p><p class="slate-p slate-indent-0-1" style="NaNpx"></p><p class="slate-p slate-indent-0-1-1-1" style="NaNpx"></p><p class="slate-p slate-indent-0-1-1-1-1-1-1-1-1-1-1" style="NaNpx"></p>

En nuestro esquema, los precios que proveemos ya incluyen un spread que contempla nuestra ganancia, por lo tanto, pueden ser utilizados directamente en la operatoria sin necesidad de ajustes adicionales. Si tu empresa desea aplicar un fee adicional a los usuarios finales, este se debe configurar por encima de nuestros precios base. Cualquier monto adicional cobrado será considerado ganancia de la empresa y podrá ser gestionado y monitoreado desde nuestro sistema de contabilidad.

<p class="slate-p slate-indent-0" style="0px">Para empresas que necesitan operar con crédito o gestionar liquidaciones de deuda, ofrecemos un sistema de contabilidad completo que permite rastrear todas las obligaciones financieras y exponerlas a través de endpoints simples para facilitar su gestión. Nuestro sistema es flexible y admite distintos modelos operativos. Consultanos por los mismos para ver cuál se acopla mejor a tu caso de uso.</p><p class="slate-p " ></p>

Para empresas que necesitan operar con crédito o gestionar liquidaciones de deuda, ofrecemos un sistema de contabilidad completo que permite rastrear todas las obligaciones financieras y exponerlas a través de endpoints simples para facilitar su gestión. Nuestro sistema es flexible y admite distintos modelos operativos. Consultanos por los mismos para ver cuál se acopla mejor a tu caso de uso.

<p class="slate-p slate-indent-0" style="0px">Para el envío de notificaciones, utilizamos webhooks. Podés configurarlos a través del API para ser notificado por cada uno de los eventos que ocurran y te sean de interés. </p><p class="slate-p slate-indent-0" style="0px">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.</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. </p><p class="slate-p slate-indent-0" style="0px">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 " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " ><span style="color:rgb(0, 0, 0)">Eventos relevantes</span></h3><div class="table-container" style="width:100%;
  min-width:100%;"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div></div><colgroup ><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >ORDER_STATUS_UPDATE</p><p class="slate-p slate-indent-0" style="0px">Este evento del sistema se emite cada vez que una Orden cambia de estado. El payload del evento será la Orden actualizada.
Consultá la sección de Órdenes para ver la interfaz IOrder.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >WITHDRAW_STATUS_UPDATE</p><p class="slate-p slate-indent-0" style="0px">Este evento del sistema se emite cada vez que un Retiro cambia de estado. El payload del evento será el Retiro actualizado.
Consultá la sección de Retiros para ver la interfaz IWithdraw.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >USER_STATUS_UPDATE</p><p class="slate-p slate-indent-0" style="0px">Este evento del sistema se emite cada vez que un Usuario cambia de estado. El payload del evento será el Usuario actualizado.
Consultá la sección de Usuarios para ver la interfaz IUser.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >SYNTHETIC_STATUS_UPDATE</p><p class="slate-p slate-indent-0" style="0px">Este evento del sistema se emite cada vez que un Synthetic cambia de estado. El payload del evento será el Synthetic actualizado.
Consultá la sección de Synthetics para ver la interfaz ISynthetic.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >DEPOSIT_DETECTED</p><p class="slate-p slate-indent-0" style="0px">Este evento del sistema se emite cada vez que un Depósito es confirmado. El payload del evento será el Depósito.
Consultá la sección de Depósitos para ver la interfaz IDeposit.</p></td></div></tr></tbody></table></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de webhook</h3><p class="slate-p " >Detallamos a continuación un ejemplo de webhook. Todos tienen el mismo formato, donde dentro de <code class="slate-code">data</code> podremos encontrar el modelo de la Entidad, tal y como llega en un GET endpoint y dentro de <code class="slate-code">event</code> podremos encontrar el nombre del evento en cuestión.</p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
  &quot;data&quot;: {
    &quot;against&quot;: &quot;ARS&quot;,
    &quot;asset&quot;: &quot;USD&quot;,
    &quot;assetAmount&quot;: &quot;1&quot;,
    &quot;companyId&quot;: &quot;6787d7d49a959cc79568e229&quot;,
    &quot;creationTime&quot;: &quot;2025-04-15T16:24:12.461-03:00&quot;,
    &quot;effectivePrice&quot;: &quot;1151&quot;,
    &quot;fee&quot;: &quot;0.5000000000&quot;,
    &quot;feeInfo&quot;: {
      &quot;companyProfit&quot;: &quot;0.5000000000&quot;,
      &quot;earningsWithholding&quot;: &quot;0&quot;,
      &quot;pais&quot;: &quot;0&quot;,
      &quot;platformFee&quot;: &quot;0.0000000000&quot;,
      &quot;totalFee&quot;: &quot;0.5000000000&quot;
    },
    &quot;filledAmount&quot;: &quot;1.00&quot;,
    &quot;finalClaimInfo&quot;: {
      &quot;asset&quot;: &quot;ARS&quot;,
      &quot;base&quot;: &quot;1151.00&quot;,
      &quot;companyProfit&quot;: &quot;575.50&quot;,
      &quot;earningsWithholding&quot;: &quot;0.00&quot;,
      &quot;pais&quot;: &quot;0.00&quot;,
      &quot;platformFee&quot;: &quot;0.00&quot;,
      &quot;total&quot;: &quot;1726.50&quot;,
      &quot;totalFees&quot;: &quot;575.50&quot;
    },
    &quot;finalCreditInfo&quot;: {
      &quot;asset&quot;: &quot;USD&quot;,
      &quot;base&quot;: &quot;1.00&quot;,
      &quot;companyProfit&quot;: &quot;0&quot;,
      &quot;earningsWithholding&quot;: &quot;0&quot;,
      &quot;pais&quot;: &quot;0&quot;,
      &quot;platformFee&quot;: &quot;0&quot;,
      &quot;total&quot;: &quot;1.00&quot;,
      &quot;totalFees&quot;: &quot;0&quot;
    },
    &quot;history&quot;: [
      {
        &quot;claimedAmount&quot;: &quot;1726.50&quot;,
        &quot;newStatus&quot;: &quot;PENDING&quot;,
        &quot;price&quot;: &quot;1151&quot;,
        &quot;stepAmount&quot;: &quot;1&quot;,
        &quot;timestamp&quot;: &quot;2025-04-15T16:24:12.457-03:00&quot;
      },
      {
        &quot;newStatus&quot;: &quot;COMPLETED&quot;,
        &quot;price&quot;: &quot;1151&quot;,
        &quot;stepAmount&quot;: &quot;1&quot;,
        &quot;timestamp&quot;: &quot;2025-04-15T16:24:12.572-03:00&quot;
      },
      {
        &quot;creditedAmount&quot;: &quot;1.00&quot;,
        &quot;refundedAmount&quot;: &quot;0.00&quot;,
        &quot;timestamp&quot;: &quot;2025-04-15T16:24:12.706-03:00&quot;
      }
    ],
    &quot;id&quot;: &quot;67feb25c9b3655142b96d37c&quot;,
    &quot;numberId&quot;: &quot;822&quot;,
    &quot;price&quot;: &quot;1151&quot;,
    &quot;settlement&quot;: &quot;INSTANT&quot;,
    &quot;side&quot;: &quot;BUY&quot;,
    &quot;status&quot;: &quot;COMPLETED&quot;,
    &quot;type&quot;: &quot;DIRECT&quot;,
    &quot;updatedAt&quot;: &quot;2025-04-15T16:24:12.711-03:00&quot;,
    &quot;userExternalId&quot;: &quot;my-external-8&quot;,
    &quot;userId&quot;: &quot;67fd663bd068cf551032440f&quot;,
    &quot;userLegalId&quot;: &quot;23262748529&quot;,
    &quot;userNumberId&quot;: &quot;318&quot;
  },
  &quot;event&quot;: &quot;ORDER_STATUS_UPDATE&quot;
}</div></div></code></pre></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 " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Para el envío de notificaciones, utilizamos webhooks. Podés configurarlos 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. 

Title

Detallamos a continuación un ejemplo de webhook. Todos tienen el mismo formato, donde dentro de 

 podremos encontrar el modelo de la Entidad, tal y como llega en un GET endpoint y dentro de 

 podremos encontrar el nombre del evento en cuestión.

<p class="slate-p slate-indent-0" style="0px">El proceso de alta de un nuevo usuario es una parte fundamental de nuestra plataforma, y constituye el primer paso obligatorio que cualquier usuario debe realizar para poder operar dentro de nuestros sistemas.</p><p class="slate-p slate-indent-0" style="0px">El flujo general del proceso de onboarding es el siguiente:
</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 " >Creación inicial del usuario</h3><p class="slate-p slate-indent-0" style="0px">Un usuario se crea con información mínima y se le asigna inicialmente el estado <code class="slate-code">ONBOARDING</code>.
Mientras se encuentra en este estado, el usuario no puede realizar ninguna operación.</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 " >Realizar todas las tareas de onboarding requeridas</h3><p class="slate-p slate-indent-0" style="0px">El usuario debe completar todas las tareas de onboarding que estén marcadas como obligatorias.
Para más detalles sobre cómo realizar cada tarea y en qué casos son necesarias, consultá la sección <a href="67fad7dd208b4be4fe96ee5a/67faf0e65324c11c14ed6a39/67fc2e2d74ccdd155c998e81" target="">tareas de onboarding</a>.
</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >El estado del usuario cambia a ACTIVE</h3><p class="slate-p slate-indent-0" style="0px">Una vez que se han completado todas las tareas de onboarding requeridas, el estado del usuario cambiará a ACTIVE,
permitiéndole comenzar a operar en la plataforma.</p><p class="slate-p " ></p></div></div></div><p class="slate-p " ></p><p class="slate-p " ></p>

El proceso de alta de un nuevo usuario es una parte fundamental de nuestra plataforma, y constituye el primer paso obligatorio que cualquier usuario debe realizar para poder operar dentro de nuestros sistemas.

El flujo general del proceso de onboarding es el siguiente:


<p class="slate-p slate-indent-0" style="0px">Las operaciones representan las distintas formas disponibles para generar órdenes dentro de la plataforma. A través de ellas, es posible convertir pesos a dólares y viceversa, de manera controlada. </p><p class="slate-p " >El flujo normal de uso, implica:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Depósito de pesos/dólares (dependiendo del esquema de contabilidad utilizado)</div></li><li class="slate-li " ><div style="position:relative">Creación de órden (con o sin bloqueo de precio)</div></li><li class="slate-li " ><div style="position:relative">Solicitud de retiro de fondos</div></li></ol><p class="slate-p slate-indent-0" style="0px">Para esto, existe tanto el método manual (que implica realizar llamados a los múltiples endpoints listados) como el método automático (que implica realizar un único llamado al <a href="67faf07b5324c11c14ed69a9/67fdc566116c5bfaf4b58310" target="">Sintético</a>).</p><p class="slate-p " ></p>

Las operaciones representan las distintas formas disponibles para generar órdenes dentro de la plataforma. A través de ellas, es posible convertir pesos a dólares y viceversa, de manera controlada. 

Para esto, existe tanto el método manual (que implica realizar llamados a los múltiples endpoints listados) como el método automático (que implica realizar un único llamado al 

<p class="slate-p slate-indent-0" style="0px">Después de que se inicia el proceso de onboarding, la entidad usuario representa la cuenta de ese individuo dentro de tu empresa.
Un mismo individuo no puede tener más de un usuario por empresa, aunque sí puede tener múltiples usuarios en distintas empresas.</p><p class="slate-p slate-indent-0" style="0px">En esos casos, el individuo compartirá los mismos límites operativos entre todas las empresas en las que tenga cuentas.</p><p class="slate-p slate-indent-0" style="0px"></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Estados posibles de usuario</h3><p class="slate-p " >Un usuario puede tener distintos estados a lo largo de su ciclo de vida. Los mismos pueden ser consultados a través de la obtención del usuario o bien a través del webhook relacionado. Los estados posibles son:</p><div class="table-container" style="width:98%;
  min-width:98%;"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:430px;">Title</div><div style="width:0px;">Description</div></div><colgroup ><col style="width:430px"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Estado</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Descripción</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >ONBOARDING</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >El usuario se encuentra en proceso de alta. Todavía no puede realizar operaciones.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >ACTIVE</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >El usuario se encuentra activo; es decir, ya puede realizar operaciones y el proceso de alta se da por finalizado.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >INACTIVE</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >El usuario se encuentra inactivo; es decir, no puede realizar operaciones</p></td></div></tr></tbody></table></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de usuario</h3><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
    &quot;id&quot;: &quot;67fd5d8c97d36f904e8ded85&quot;,
    &quot;numberId&quot;: &quot;313&quot;,
    &quot;email&quot;: &quot;weddeuxoicrekeu-9657@yopmail.com&quot;,
    &quot;status&quot;: &quot;ONBOARDING&quot;,
    &quot;type&quot;: &quot;INDIVIDUAL&quot;,
    &quot;exchange&quot;: &quot;ARGENTINA&quot;,
    &quot;banking&quot;: {
        &quot;accounts&quot;: [
            {
                &quot;cbu&quot;: &quot;0000003100075086465852&quot;,
                &quot;currency&quot;: &quot;ARS&quot;,
                &quot;description&quot;: &quot;Optional description&quot;,
                &quot;bank&quot;: {
                    &quot;code&quot;: &quot;123&quot;,
                    &quot;name&quot;: &quot;Banco Gariboldi Garibiano&quot;
                },
                &quot;virtual&quot;: false
            },
            {
                &quot;cbu&quot;: &quot;0000003100075086465852&quot;,
                &quot;currency&quot;: &quot;USD&quot;,
                &quot;description&quot;: &quot;Optional description&quot;,
                &quot;bank&quot;: {
                    &quot;code&quot;: &quot;123&quot;,
                    &quot;name&quot;: &quot;Banco Gariboldi Garibiano&quot;
                },
                &quot;virtual&quot;: false
            }
        ]
    },
    &quot;onboarding&quot;: {
        &quot;EMAIL_VALIDATION&quot;: {
            &quot;required&quot;: false,
            &quot;status&quot;: &quot;PENDING&quot;
        },
        &quot;IDENTITY_DECLARATION&quot;: {
            &quot;required&quot;: true,
            &quot;status&quot;: &quot;COMPLETED&quot;
        },
        &quot;BASIC_PERSONAL_DATA_DEFINITION&quot;: {
            &quot;required&quot;: true,
            &quot;status&quot;: &quot;PENDING&quot;
        },
        &quot;WORK_DEFINITION&quot;: {
            &quot;required&quot;: true,
            &quot;status&quot;: &quot;PENDING&quot;
        },
        &quot;POLITICAL_CONSTRAINTS_VALIDATION&quot;: {
            &quot;required&quot;: true,
            &quot;status&quot;: &quot;PENDING&quot;
        },
        &quot;SECURITY_VALIDATION&quot;: {
            &quot;required&quot;: true,
            &quot;status&quot;: &quot;PENDING&quot;
        },
        &quot;BANK_ACCOUNT_DEFINITION&quot;: {
            &quot;required&quot;: true,
            &quot;status&quot;: &quot;COMPLETED&quot;
        },
        &quot;FEP_DOCUMENTATION_VALIDATION&quot;: {
            &quot;required&quot;: false,
            &quot;status&quot;: &quot;PENDING&quot;
        },
        &quot;PEP_DOCUMENTATION_VALIDATION&quot;: {
            &quot;required&quot;: false,
            &quot;status&quot;: &quot;PENDING&quot;
        },
        &quot;IDENTITY_VALIDATION&quot;: {
            &quot;required&quot;: true,
            &quot;status&quot;: &quot;IN_PROGRESS&quot;
        },
        &quot;SELFIE_VALIDATION&quot;: {
            &quot;required&quot;: false,
            &quot;status&quot;: &quot;IN_PROGRESS&quot;
        }
    },
    &quot;creationTime&quot;: &quot;2025-04-14T16:10:04.014-03:00&quot;,
    &quot;updatedAt&quot;: &quot;2025-04-14T16:20:16.621-03:00&quot;,
    &quot;legalId&quot;: &quot;24343320961&quot;,</div><div class="slate-code_line">}
}</div></div></code></pre></div><p class="slate-p " ></p><p class="slate-p " ></p>

Después de que se inicia el proceso de onboarding, la entidad usuario representa la cuenta de ese individuo dentro de tu empresa.
Un mismo individuo no puede tener más de un usuario por empresa, aunque sí puede tener múltiples usuarios en distintas empresas.

En esos casos, el individuo compartirá los mismos límites operativos entre todas las empresas en las que tenga cuentas.

Un usuario puede tener distintos estados a lo largo de su ciclo de vida. Los mismos pueden ser consultados a través de la obtención del usuario o bien a través del webhook relacionado. Los estados posibles son:

Description

<p class="slate-p slate-indent-0" style="0px">La entidad Persona representa al individuo en sí mismo, y agrupa toda la información personal, regulatoria y operativa asociada a esa identidad. Una persona puede estar vinculada a múltiples usuarios, lo que permite que el mismo individuo tenga cuentas activas en diferentes empresas o contextos dentro de la plataforma.</p><p class="slate-p slate-indent-0" style="0px">A diferencia de los usuarios, que son entidades asociadas a una empresa en particular, la entidad Persona es única por individuo y actúa como eje central para:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Información personal (nombre, documento, CUIT, etc.)</div></li><li class="slate-li " ><div style="position:relative">Estado regulatorio (compliance, PEP/FEP, bloqueos, etc.)</div></li><li class="slate-li " ><div style="position:relative">Límites operativos</div></li></ul><p class="slate-p " ></p><div class="slate-div"><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de persona</h3></div><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
    &quot;legalId&quot;: &quot;23389271334&quot;,
    &quot;email&quot;: &quot;user@test.com&quot;,
    &quot;personalData&quot;: {
        &quot;name&quot;: &quot;Test&quot;,
        &quot;surname&quot;: &quot;User&quot;,
        &quot;work&quot;: &quot;SERVICIOS COMPLEMENTARIOS DE APOYO TURÍSTICO N.C.P.&quot;,
        &quot;birthDate&quot;: &quot;1993-01-01&quot;,
        &quot;address&quot;: {
            &quot;postalCode&quot;: &quot;1400&quot;,
            &quot;locality&quot;: &quot;CABA&quot;,
            &quot;province&quot;: &quot;CABA&quot;,
            &quot;street&quot;: &quot;asd&quot;,
            &quot;numeration&quot;: &quot;1000&quot;,
            &quot;floor&quot;: &quot;8C&quot;
        },
        &quot;document&quot;: {
            &quot;type&quot;: &quot;DNI&quot;,
            &quot;id&quot;: &quot;34956133&quot;
        },
        &quot;phoneNumber&quot;: &quot;+5491124000000&quot;,
        &quot;sex&quot;: &quot;M&quot;,
        &quot;maritalStatus&quot;: &quot;Soltero&quot;,
        &quot;nationality&quot;: &quot;Argentina&quot;,
        &quot;cleanName&quot;: &quot;Test User&quot;,
        &quot;IVA&quot;: &quot;Responsable monotributo&quot;,
        &quot;ganancias&quot;: &quot;Responsable monotributo&quot;
    },
    &quot;flags&quot;: {
        &quot;isDead&quot;: false,
        &quot;isPEP&quot;: false,
        &quot;isUIF&quot;: false,
        &quot;isFATCA&quot;: false
    },
    &quot;creationTime&quot;: &quot;2024-04-08T13:10:40.819-03:00&quot;,
    &quot;updatedAt&quot;: &quot;2024-04-08T13:31:12.692-03:00&quot;</div><div class="slate-code_line">}</div><div class="slate-code_line"></div></div></code></pre></div><p class="slate-p " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de límites</h3><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
  &quot;id&quot;: &quot;67fe7f61625e6ce15ba103a1&quot;,
  &quot;legalId&quot;: &quot;23389271334&quot;,
  &quot;totalMonthlyOperated&quot;: {
    &quot;042025&quot;: &quot;11.00&quot;
  },
  &quot;totalYearlyOperated&quot;: {
    &quot;2025&quot;: &quot;12111.00&quot;
  },
  &quot;yearLimit&quot;: &quot;0&quot;,
  &quot;monthLimit&quot;: &quot;10000000&quot;,
  &quot;creationTime&quot;: &quot;2025-04-15T12:46:41.335-03:00&quot;,
  &quot;updatedAt&quot;: &quot;2025-04-15T13:35:18.494-03:00&quot;
}</div></div></code></pre></div><p class="slate-p " ></p>

La entidad Persona representa al individuo en sí mismo, y agrupa toda la información personal, regulatoria y operativa asociada a esa identidad. Una persona puede estar vinculada a múltiples usuarios, lo que permite que el mismo individuo tenga cuentas activas en diferentes empresas o contextos dentro de la plataforma.

A diferencia de los usuarios, que son entidades asociadas a una empresa en particular, la entidad Persona es única por individuo y actúa como eje central para:

Test

<p class="slate-p slate-indent-0" style="0px">Cada usuario tiene asociada una entidad de Balance, donde se mantiene su balance actual. A diferencia de otras entidades, no posee un identificador propio, sino que utiliza el mismo ID que el usuario al que pertenece.</p><p class="slate-p slate-indent-0" style="0px"></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de balance</h3><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
    &quot;userId&quot;: &quot;67fdc51b0976f3df18bae9ff&quot;,
    &quot;userNumberId&quot;: &quot;321&quot;,
    &quot;userExternalId&quot;: &quot;my-external-1&quot;,
    &quot;balance&quot;: {
        &quot;ARS&quot;: &quot;100000.00&quot;
    },
    &quot;lockedBalance&quot;: {},
    &quot;creationTime&quot;: &quot;2025-04-14T23:31:55.414-03:00&quot;,
    &quot;updatedAt&quot;: &quot;2025-04-14T23:31:55.414-03:00&quot;
}</div></div></code></pre></div><p class="slate-p " ></p><p class="slate-p " ></p>

Cada usuario tiene asociada una entidad de Balance, donde se mantiene su balance actual. A diferencia de otras entidades, no posee un identificador propio, sino que utiliza el mismo ID que el usuario al que pertenece.

<p class="slate-p slate-indent-0" style="0px">Una entidad de depósito se crea automáticamente cada vez que llegan fondos a una de nuestras direcciones del sistema, a través de cualquiera de las redes soportadas. Los mismos pueden ser en ARS o USD y no tienen status; pues si existen, es porque son siempre depósitos que se encuentran asignados.</p><p class="slate-p slate-indent-0-1" style="NaNpx"></p><p class="slate-p slate-indent-0-1-1" style="NaNpx"></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de depósito</h3><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
    &quot;id&quot;: &quot;67fdd5588fae67ea6f21eea4&quot;,
    &quot;numberId&quot;: &quot;6&quot;,
    &quot;network&quot;: &quot;MANTECA&quot;,
    &quot;networkId&quot;: &quot;cdcbae8b-9818-41cc-902d-70ed60397737&quot;,
    &quot;companyId&quot;: &quot;6787d7d49a959cc79568e229&quot;,
    &quot;userId&quot;: &quot;67fd663bd068cf551032440f&quot;,
    &quot;userNumberId&quot;: &quot;318&quot;,
    &quot;userLegalId&quot;: &quot;23262188529&quot;,
    &quot;userExternalId&quot;: &quot;my-external-8&quot;,
    &quot;source&quot;: &quot;1290001713039384360017&quot;,
    &quot;asset&quot;: &quot;ARS&quot;,
    &quot;amount&quot;: &quot;100000.45&quot;,
    &quot;creationTime&quot;: &quot;2025-04-15T00:41:12.972-03:00&quot;,
    &quot;updatedAt&quot;: &quot;2025-04-15T00:41:12.972-03:00&quot;
}</div></div></code></pre></div><p class="slate-p " ></p>

Una entidad de depósito se crea automáticamente cada vez que llegan fondos a una de nuestras direcciones del sistema, a través de cualquiera de las redes soportadas. Los mismos pueden ser en ARS o USD y no tienen status; pues si existen, es porque son siempre depósitos que se encuentran asignados.

<p class="slate-p slate-indent-0" style="0px">Un retiro consiste en extraer fondos de nuestro sistema y enviarlos a un CBU/CVU externo.</p><p class="slate-p " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " ><span style="color:rgb(0, 0, 0)">Estados posibles de un retiro</span></h3><p class="slate-p " ><span style="color:rgb(0, 0, 0)">Un retiro puede tener distintos estados a lo largo de su ciclo de vida. Los mismos pueden ser consultados a través de la obtención del retiro o bien a través del webhook relacionado. Los estados posibles son:</span></p><div class="table-container" style="width:100%;min-width:100%"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div><div style="width:100px;">Description</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">Estado</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">Descripción</span></p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">PENDING</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">El retiro se encuentra pendiente a ser enviado.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">PROCESSING</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">El retiro fue procesado, pero aún sin confirmación de éxito.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">EXECUTED</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">El retiro llego a su destino de manera exitosa.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >CANCELLED</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">El retiro tuvo un error irrecuperable por lo cual fue cancelado y los fondos devueltos al usuario.</p></td></div></tr></tbody></table></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de retiro</h3><p class="slate-p " ></p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
    &quot;id&quot;: &quot;67fe7cd1625e6ce15ba102b7&quot;,
    &quot;numberId&quot;: &quot;121&quot;,
    &quot;network&quot;: &quot;MANTECA&quot;,
    &quot;companyId&quot;: &quot;6787d7d49a959cc79568e229&quot;,
    &quot;userId&quot;: &quot;67fd663bd068cf551032440f&quot;,
    &quot;userNumberId&quot;: &quot;318&quot;,
    &quot;userExternalId&quot;: &quot;my-external-8&quot;,
    &quot;userLegalId&quot;: &quot;23262188529&quot;,
    &quot;destination&quot;: &quot;1290001713039384360017&quot;,
    &quot;status&quot;: &quot;PENDING&quot;,
    &quot;asset&quot;: &quot;ARS&quot;,
    &quot;amount&quot;: &quot;1000.00&quot;,
    &quot;creationTime&quot;: &quot;2025-04-15T12:35:45.606-03:00&quot;,
    &quot;updatedAt&quot;: &quot;2025-04-15T12:35:45.606-03:00&quot;
}</div></div></code></pre></div><p class="slate-p " ></p><p class="slate-p " ></p>

Un retiro consiste en extraer fondos de nuestro sistema y enviarlos a un CBU/CVU externo.

Un retiro puede tener distintos estados a lo largo de su ciclo de vida. Los mismos pueden ser consultados a través de la obtención del retiro o bien a través del webhook relacionado. Los estados posibles son:

<p class="slate-p slate-indent-0" style="0px">Una órden representa una instrucción formal para ejecutar una operación de intercambio entre dos activos, como por ejemplo convertir pesos a dólares o dólares a pesos. El mínimo de operación es de 1 dólar.

Existen distintos tipos de órdenes disponibles en la plataforma, cada una con una lógica de ejecución particular:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Órden directa: la operación se ejecuta de forma inmediata al precio disponible en ese momento. No pasa por ningún libro de órdenes y se fillea instantáneamente.</div></li><li class="slate-li " ><div style="position:relative">Órden vía Orderbook: la operación se realiza mediante el uso de un libro de órdenes.</div></li></ul><p class="slate-p " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Estados posibles de una órden</h3><div class="table-container" style="width:100%;min-width:100%"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div><div style="width:100px;">Description</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Estado</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Descripción</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >PENDING</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >La órden está pendiente de ejecución.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >FAILED</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >La órden falló.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >COMPLETED</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >La órden fue completada.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >CANCELLED</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >La órden fue manualmente cancelada.</p></td></div></tr></tbody></table></div><p class="slate-p " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de órden</h3><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
    &quot;id&quot;: &quot;67fdd98112794b975dc6245d&quot;,
    &quot;numberId&quot;: &quot;786&quot;,
    &quot;companyId&quot;: &quot;6787d7d49a959cc79568e229&quot;,
    &quot;userId&quot;: &quot;67fd663bd068cf551032440f&quot;,
    &quot;userNumberId&quot;: &quot;318&quot;,
    &quot;userLegalId&quot;: &quot;23262748529&quot;,
    &quot;userExternalId&quot;: &quot;my-external-8&quot;,
    &quot;status&quot;: &quot;COMPLETED&quot;,
    &quot;side&quot;: &quot;BUY&quot;,
    &quot;type&quot;: &quot;DIRECT&quot;,
    &quot;settlement&quot;: &quot;INSTANT&quot;,
    &quot;asset&quot;: &quot;USD&quot;,
    &quot;against&quot;: &quot;ARS&quot;,
    &quot;assetAmount&quot;: &quot;5&quot;,
    &quot;filledAmount&quot;: &quot;5.00&quot;,
    &quot;price&quot;: &quot;1151&quot;,          //Precio base sin fees 
    &quot;effectivePrice&quot;: &quot;1151&quot;, //Precio final cobrado 
    &quot;fee&quot;: &quot;0.0000000000&quot;,
    &quot;feeInfo&quot;: {
        &quot;platformFee&quot;: &quot;0.0000000000&quot;,
        &quot;companyProfit&quot;: &quot;0.0000000000&quot;,
        &quot;pais&quot;: &quot;0&quot;,
        &quot;earningsWithholding&quot;: &quot;0&quot;,
        &quot;totalFee&quot;: &quot;0.0000000000&quot;
    },
    &quot;finalClaimInfo&quot;: {      //Data de lo que se debita 
        &quot;asset&quot;: &quot;ARS&quot;,
        &quot;total&quot;: &quot;5755.00&quot;,
        &quot;base&quot;: &quot;5755.00&quot;,
        &quot;totalFees&quot;: &quot;0.00&quot;,
        &quot;platformFee&quot;: &quot;0.00&quot;,
        &quot;companyProfit&quot;: &quot;0.00&quot;,
        &quot;pais&quot;: &quot;0.00&quot;,
        &quot;earningsWithholding&quot;: &quot;0.00&quot;
    },
    &quot;finalCreditInfo&quot;: {      //Data de lo que se acredita 
        &quot;asset&quot;: &quot;USD&quot;,
        &quot;total&quot;: &quot;5.00&quot;,
        &quot;base&quot;: &quot;5.00&quot;,
        &quot;totalFees&quot;: &quot;0&quot;,
        &quot;platformFee&quot;: &quot;0&quot;,
        &quot;companyProfit&quot;: &quot;0&quot;,
        &quot;pais&quot;: &quot;0&quot;,
        &quot;earningsWithholding&quot;: &quot;0&quot;
    },
    &quot;history&quot;: [
        {
            &quot;timestamp&quot;: &quot;2025-04-15T00:58:57.549-03:00&quot;,
            &quot;newStatus&quot;: &quot;PENDING&quot;,
            &quot;stepAmount&quot;: &quot;5&quot;,
            &quot;price&quot;: &quot;1151&quot;,
            &quot;claimedAmount&quot;: &quot;5755.00&quot;
        },
        {
            &quot;timestamp&quot;: &quot;2025-04-15T00:58:57.682-03:00&quot;,
            &quot;newStatus&quot;: &quot;COMPLETED&quot;,
            &quot;stepAmount&quot;: &quot;5&quot;,
            &quot;price&quot;: &quot;1151&quot;
        },
        {
            &quot;timestamp&quot;: &quot;2025-04-15T00:58:57.764-03:00&quot;,
            &quot;creditedAmount&quot;: &quot;5.00&quot;,
            &quot;refundedAmount&quot;: &quot;0.00&quot;
        }
    ],
    &quot;creationTime&quot;: &quot;2025-04-15T00:58:57.554-03:00&quot;,
    &quot;updatedAt&quot;: &quot;2025-04-15T00:58:57.765-03:00&quot;
</div></div></code></pre></div><p class="slate-p " ></p>

Una órden representa una instrucción formal para ejecutar una operación de intercambio entre dos activos, como por ejemplo convertir pesos a dólares o dólares a pesos. El mínimo de operación es de 1 dólar.

Existen distintos tipos de órdenes disponibles en la plataforma, cada una con una lógica de ejecución particular:

<p class="slate-p slate-indent-0" style="0px">La entidad Sintético contiene toda la información relevante relacionada con la configuración y el estado actual de un flujo automático, incluyendo:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Estado general del synthetic</div></li><li class="slate-li " ><div style="position:relative">Etapas que lo componen y sus respectivos detalles</div></li><li class="slate-li " ><div style="position:relative">Etapa actual en ejecución o en espera de ejecución</div></li></ul><p class="slate-p slate-indent-0" style="0px">Una operación de ramp se define como un flujo compuesto por:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Etapa de depósito: se espera que el usuario envíe fondos a una dirección del sistema.</div></li><li class="slate-li " ><div style="position:relative">Etapa de orden: se utilizan los fondos recibidos para ejecutar una operación de intercambio.</div></li><li class="slate-li " ><div style="position:relative">Etapa de retiro: se envían los activos resultantes de la orden a una dirección externa.</div></li></ol><div class="slate-div"><p class="slate-p slate-indent-0" style="0px">La etapa de depósito puede no estar presente si la configuración de la empresa permite operar con deuda, y siempre que no se haya deshabilitado explícitamente el uso de deuda al momento de construir el synthetic. En ese caso, el synthetic comienza directamente en la etapa de orden.</p></div><p class="slate-p " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Etapas</h3><p class="slate-p slate-indent-0" style="0px">Las etapas representan una acción puntual que el synthetic debe ejecutar cuando la alcanza. Todas las etapas comparten una estructura común, y extienden esa base para incluir su propia información adicional.</p><p class="slate-p slate-indent-0" style="0px"></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Estados posibles de un sintético</h3><p class="slate-p " ><span style="color:rgb(0, 0, 0)">Un sint</span>ético puede tener múltiples estados:</p><div class="table-container" style="width:100%;min-width:100%"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div><div style="width:100px;">Description</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">Estado</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">Descripci</span>ón</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">STARTING</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">El synthetic acaba de ser creado y se encuentra preparándose para ejecutar la primera etapa o esperando que se cumpla el tiempo de ejecución asignado a dicha etapa.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">ACTIVE</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">La etapa actual del synthetic está siendo procesada activamente. El significado exacto de este procesamiento dependerá del tipo de etapa que se esté ejecutando.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">WAITING</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">El synthetic está esperando a que se cumplan las condiciones necesarias para ejecutar la etapa actual, como por ejemplo, alcanzar el momento de ejecución definido.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">PAUSED</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">El synthetic fue pausado manualmente mientras se encontraba en estado WAITING, y no ejecutará la siguiente etapa hasta que se reanude, incluso si ya se cumplen las condiciones necesarias para continuar.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">COMPLETED</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Todas las etapas del synthetic han sido ejecutadas.
Esto no significa que todos los procesos relacionados a la operación hayan finalizado —por ejemplo, un retiro podría seguir esperando confirmaciones en la red—, pero desde el punto de vista del synthetic, su responsabilidad concluye una vez que confirma que la solicitud de retiro fue enviada correctamente a la red.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><span style="color:rgb(0, 0, 0)">CANCELLED</span></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">El synthetic ha sido cancelado, y este es un estado final.
El motivo de la cancelación se encuentra detallado en el campo cancellationReason</p></td></div></tr></tbody></table></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Ejemplo de sintético</h3><p class="slate-p " ></p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-plainText keep-markup drop-tokens"></code></pre></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

La entidad Sintético contiene toda la información relevante relacionada con la configuración y el estado actual de un flujo automático, incluyendo:

Una operación de ramp se define como un flujo compuesto por:

Las etapas representan una acción puntual que el synthetic debe ejecutar cuando la alcanza. Todas las etapas comparten una estructura común, y extienden esa base para incluir su propia información adicional.

<p class="slate-p slate-indent-0" style="0px">La mayoría de las consultas permiten utilizar el parámetro userAnyId, que acepta cualquiera de los identificadores del usuario:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><code class="slate-code">id</code></div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">numberId</code></div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">externalId</code></div></li></ul><p class="slate-p " ></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " >Filtros comunes</h3><p class="slate-p slate-indent-0" style="0px">En los endpoints que permiten obtener múltiples documentos, se pueden aplicar filtros para paginación y búsqueda, como por ejemplo:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">page=1</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">limit=20</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">userAnyId=someId</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">legalId=someLegalId</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">email=some@email.com</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">status=someStatus</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">sessionId=someId</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">partialEmail=some@em</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">partialLegalId=someLega</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">from=2024-01-01T00:00:00Z (ISO date)</span></div></li><li class="slate-li " ><div style="position:relative"><span style="color:rgb(0, 0, 0)">to=2024-12-31T23:59:59Z (ISO date)</span></div></li></ul><p class="slate-p " ></p>

La mayoría de las consultas permiten utilizar el parámetro userAnyId, que acepta cualquiera de los identificadores del usuario:

En los endpoints que permiten obtener múltiples documentos, se pueden aplicar filtros para paginación y búsqueda, como por ejemplo:

<p class="slate-p slate-indent-0" style="0px">En esta sección se centraliza toda la información relacionada con el cumplimiento normativo de las personas.
Incluye:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Límites operativos: se detallan los topes mensuales y anuales definidos por el sistema para cada usuario, incluyendo su uso actual y la fecha de actualización.</div></li><li class="slate-li " ><div style="position:relative">Documentación de orígenes de fondos: se listan los documentos presentados por la persona, junto con su estado (pendiente, aprobado, rechazado).</div></li></ul><p class="slate-p " ></p>

En esta sección se centraliza toda la información relacionada con el cumplimiento normativo de las personas.
Incluye:

<p class="slate-p slate-indent-0" style="0px">Los precios ofrecidos por la plataforma son precios finales. En caso de tener configuradas comisiones, el precio ya las incluirá. Para consultarlos, se debe utilizar el siguiente endpoint. En caso de querer consumir los precios de manera pública; es decir, sin importar las comisiones, se puede reemplazar el <code class="slate-code">/api/</code> por <code class="slate-code">/public</code>/.</p>

Los precios ofrecidos por la plataforma son precios finales. En caso de tener configuradas comisiones, el precio ya las incluirá. Para consultarlos, se debe utilizar el siguiente endpoint. En caso de querer consumir los precios de manera pública; es decir, sin importar las comisiones, se puede reemplazar el 

md-api-key

prices

effectivePrices

<p class="slate-p slate-indent-0" style="0px">Cada orden registrada en el sistema cuenta con un boleto de operación asociado, que actúa como respaldo documental y comprobante formal. El boleto puede ser descargado mediante una URL firmada, la cual se genera de forma segura para acceder al archivo PDF correspondiente. Esta URL es válida por un período limitado de tiempo.</p>

Cada orden registrada en el sistema cuenta con un boleto de operación asociado, que actúa como respaldo documental y comprobante formal. El boleto puede ser descargado mediante una URL firmada, la cual se genera de forma segura para acceder al archivo PDF correspondiente. Esta URL es válida por un período limitado de tiempo.

orderAnyId

<p class="slate-p " >Para obtener el estado actual del mercado, se debe utilizar el siguiente endpoint.
 La respuesta será un valor simple:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><code class="slate-code">OPEN</code>: el mercado está abierto y permite operar. </div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">CLOSED</code>: el mercado está cerrado y no se pueden realizar operaciones.</div></li></ul><p class="slate-p " ></p>

Para obtener el estado actual del mercado, se debe utilizar el siguiente endpoint.
 La respuesta será un valor simple:

Sections