Remuneración de Saldo

El módulo de Remuneración de Saldo le permite a tu plataforma ofrecer rendimiento automático sobre los saldos disponibles de tus usuarios, sin que tengas que gestionar la operatoria de fondos. Al cierre de cada día hábil, API Broker suscribe automáticamente los saldos ociosos al Fondo Común de Inversión Money Market correspondiente, y los rescata al inicio del siguiente día para mantener la disponibilidad.
La integración es 100% vía API y webhooks. Una vez activada, no requiere intervención manual de tu parte: API Broker se encarga de toda la lógica de suscripción y rescate. Tus usuarios mantienen disponibilidad de sus fondos, y vos sumás un nuevo canal de revenue a través del fee de gestión.

Monedas soportadas

ARS → FCI Adcap Ahorro Pesos (Clase H1, Money Market, liquidez T+0)
USD → FCI Adcap Ahorro Dólar (Clase H1, Money Market, liquidez T+0)

¿Como funciona?

El flujo opera de forma completamente automática, sin intervención del partner:

El usuario/comitente mantiene saldo disponible en su cuenta comitente.
Al cierre del día hábil, API Broker identifica el saldo ocioso y lo suscribe al FCI correspondiente (ARS o USD).
Al inicio del siguiente día hábil, API Broker habilita la posibilidad de utilizar los fondos para extracciónes (cash-out) u operaciones de mercado (compra de títulos, suscripciones a FCI, etc).
Una vez actualizado el valor de cuotaparte, el usuario puede ver acreditado el rendimiento en su saldo disponible.

Uso intradiario y descubierto

A partir de las 10:00 hs (horario sujeto a la integración bancaria de cada partner), los usuarios pueden utilizar fondos remunerados.
Cuando el usuario realiza un consumo, retiro u operación que requiere disponibilidad inmediata, el monto utilizado se registra como un descubierto intradiario en su cuenta comitente.

Ese descubierto se cubre automáticamente mediante un rescate total del fondo, gestionado por API Broker.

Al finalizar cada día hábil, previo al horario de corte de los fondos y habiendose actualizado el valor de cuotaparte:

Se rescata el monto necesario para cubrir los adelantos generados por el uso intradiario.
A todos los usuarios que remuneran saldo y poseen saldo disponible, se les suscribe automáticamente al FCI.

Todo el ciclo es completamente automático y transparente de cara al cliente.

Flujo de integración

A continuación se describe el orden recomendado para integrar el módulo.
El onboarding base ( proceso de alta de persona, documentación, cuenta comitente y cuenta bancaria) es un prerequisito

Ver flujo de onboarding

a. Onboarding de usuarios y cuentas

Si el usuario aún no fue dado de alta, se deben completar los pasos estándar de onboarding:

Crear persona → POST /v2/persons
Subir documentación → POST /identity-document
Crear cuenta comitente → POST /v2/investment-accounts
Registrar cuentas bancarias → POST /bank-accounts

El resultado de este proceso es una investment_account_id lista para recibir depósitos y activar remuneración.

b. Aceptación de Términos y Condiciones

Antes de activar la remuneración, el usuario debe aceptar los Términos y Condiciones específicos del módulo.

Obtener los TyC vigentes:

GET /terms?term_type=continuous_remuneration

Registrar la aceptación:

POST /accept-terms-and-conditions

Este paso es obligatorio. Sin la aceptación de TyC, la activación de la remuneración continua será rechazada.

c. Activación de Remuneración Continua

Una vez aceptados los TyC, se configura la regla de remuneración por cuenta comitente:

PUT /continuous-remuneration

El endpoint recibe los siguientes parámetros por investment_account_id:

Parámetro	Tipo	Descripción
`allow_continuous_remuneration`	boolean	Activa o desactiva la remuneración
`currency_id`	string	Moneda a remunerar: `ARS` o `USD`
`minimum_left`	number	Monto mínimo a dejar sin remunerar en la cuenta

Ejemplo de uso del minimum_left: Si un usuario tiene $10.000 y el partner configura minimum_left: 2000, se remunearán $8.000 y se dejarán $2.000 líquidos. Esto es útil para que el partner tenga espalda en caso de necesitar adelantar fondos durante el fin de semana.

La funcionalidad puede activarse o desactivarse en cualquier momento. Al desactivarla, los saldos al cierre del día quedan disponibles sin remunerar.

d. Depósitos (Cash In)

En base al volumen operado, el partner puede elegir uno de dos modelos:

Recaudadora bancaria CBU en BIND (mecanismo por defecto)

API Broker monitorea en tiempo real los depósitos bancarios, identifica al depositante por CUIT y acredita de forma inmediata el saldo en la cuenta comitente.

Recaudación vía PSP (alternativa)

Para partners que buscan mejorar procesos conciliatorios, reducir latencia y costos. API Broker, en conjunto con Adcap Securities, puede ofrecer una cuenta recaudadora a nombre de Adcap provista por el PSP. Para esto, el partner PSP debe:

Desarrollar una serie de endpoints para la integración con Adcap.
Disponer a Adcap de un sistema de backoffice para monitorear en tiempo real los movimientos de la cuenta.

En ambos casos, API Broker acredita el saldo y notifica vía webhook deposit_create.

e. Retiros (Cash Out)

El partner ordena retiros desde la cuenta comitente hacia una cuenta bancaria validada. Los retiros son asincrónicos y compatibles con Remuneración Continua.

Endpoint:

POST /withdraw-requests

Webhook de seguimiento: withdraw_request_update

Estados posibles:

IN_PROGRESS → Retiro en proceso
COMPLETED → Retiro exitoso
REJECTED → Retiro rechazado

f. Visualización de saldos y rendimiento

El partner puede obtener en tiempo real el saldo disponible, el saldo remunerado, la composición por moneda y los movimientos recientes.

Endpoint:

GET /portfolio/accountstatements/{investment_account_id}?include_remunerated_balance=true

El response incluye el objeto remunerated_balance con desglose de montos.

Servicios a integrar – Resumen de endpoints

1. Onboarding

Acción	Endpoint
Alta de persona	`POST /v2/persons`
Carga de documentos	`POST /identity-documents`
Alta de cuenta comitente	`POST /v2/investment-accounts`
Alta de cuentas bancarias	`POST /bank-accounts`

2. Términos y Condiciones

Acción	Endpoint
Obtener TyC de remuneración	`GET /terms?term_type=continuous_remuneration`
Registrar aceptación	`POST /accept-terms-and-conditions`

3. Ingreso de fondos (Cash In)

El usuario transfiere a la cuenta recaudadora de Adcap. API Broker acredita el saldo y envía webhook deposit_create.

4. Activación de Remuneración Continua

Acción	Endpoint
Configurar regla por cuenta	`PUT /continuous-remuneration`

Parámetros: currency_id (ARS/USD), minimum_left, allow_continuous_remuneration.

5. Cash Out (Retiros)

Acción	Endpoint / Webhook
Solicitud de retiro	`POST /withdraw-requests`
Seguimiento de estado	Webhook `withdraw_request_update`

6. Consulta de saldos y remuneración

Acción	Endpoint
Estado de cuenta con saldo remunerado	`GET /portfolio/accountstatements/{investment_account_id}?include_remunerated_balance=true`

Fondos Comunes de Inversión asociados

Moneda	Fondo	Clase	Tipo	Liquidez
ARS	Adcap Ahorro Pesos	H1	Money Market	T+0
USD	Adcap Ahorro Dólar	H1	Money Market	T+0S

Puntos clave para recordar

El onboarding es prerequisito: El usuario debe tener una investment_account_id activa antes de activar la remuneración.
Los TyC son obligatorios: Sin aceptación explícita, no se puede activar la remuneración continua.
El partner no opera manualmente: API Broker gestiona suscripciones y rescates de forma automática.
El usuario no pierde disponibilidad: Los fondos están accesibles desde las 9:00 hs del día hábil siguiente.
minimum_left da control al partner: Permite configurar cuánto saldo mínimo queda líquido sin remunerar.
Retiros son asincrónicos: Siempre seguir el estado vía webhook withdraw_request_update.
Saldo remunerado se consulta con parámetro: Usar include_remunerated_balance=true en el endpoint de account statements.