Depósitos – Cash In

El ingreso de fondos en API Broker es un proceso 100% asincrónico. El usuario realiza una transferencia bancaria y API Broker detecta el depósito, lo asocia a la cuenta comitente correspondiente y notifica al partner mediante un webhook. Tu plataforma no necesita hacer polling: simplemente recibe el evento y actualiza el saldo del usuario.

¿Cómo funciona?

Usuario transfiere → Banco detecta el crédito → API Broker identifica al depositante por CUIT
      → Acredita en investment_account_id → Dispara webhook deposit_create → Tu plataforma actualiza UI

Todo el proceso ocurre de forma automática. No hay ningún endpoint que el partner deba llamar para iniciar o confirmar un depósito.

Modelos de ingreso

Opción 1 — Recaudadora bancaria BIND (por defecto)

Adcap Securities disponibiliza cuentas bancarias recaudadoras (CBU) en ARS y USD dentro del banco BIND. El usuario transfiere desde cualquier cuenta bancaria hacia ese CBU.

API Broker monitorea los movimientos en tiempo real, identifica al depositante por CUIT y acredita el saldo en la cuenta comitente correspondiente.

Requisito clave: el CBU de origen de la transferencia debe pertenecer al mismo titular que la cuenta comitente (mismo CUIT). No se acreditan depósitos de terceros.

Opción 2 — Recaudadora PSP o Banco

Para partners que operan como Proveedor de Servicios de Pago o como Banco y buscan reducir latencia y costos. En este modelo, Adcap opera una cuenta recaudadora (CVU/CBU) dentro del PSP y/o Banco del partner.

Requiere que el partner desarrolle y exponga una serie de endpoints para que API Broker pueda consultar movimientos, saldos e instruir transferencias.

Webhook: deposit_create

Cuando un depósito es acreditado exitosamente, API Broker envía una notificación POST a la URL de webhook configurada para tu plataforma.

Configuración

Tu plataforma debe exponer una URL pública accesible desde internet, sin VPN. La URL se registra durante la etapa de Homologación junto con el equipo de API Broker y durante la integración en los ambientes de prueba.

Topic

deposit_create

Payload de ejemplo

{
  "topic": "deposit_create",
  "items": [
    {
      "investment_account_id": 43101,
      "currency_id": "ARS",
      "amount": 50000.00,
      "trade_date": "2025-06-10",
      "status_id": "COMPLETED",
      "deposit_id": 631184,
      "tax_identification_value": "20301234567"
    }
  ]
}

Descripción de campos

Respuesta esperada al webhook

Tu endpoint debe responder con HTTP 200 para confirmar la recepción. Si API Broker no recibe una respuesta exitosa, reintentará el envío.

Procesá el webhook de forma idempotente: es posible recibir el mismo evento más de una vez ante reintentos. Usá el deposit_id como clave de deduplicación.

Consulta de saldo post-depósito

Una vez recibido el webhook, podés confirmar el saldo acreditado consultando el estado de cuenta:

GET /api/portfolio/accountstatements/{investment_account_id}

Si el módulo de Remuneración de Saldo está activo, incluir:

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

Monedas soportadas

Consideraciones operativas

• La identificación es por CUIT: si el depositante no tiene una cuenta comitente activa o el CUIT no coincide con el CBU de origen, el depósito no se acredita automáticamente.
• No usar polling: no es necesario consultar el estado del depósito periódicamente. El webhook deposit_create es la señal confiable de acreditación.
• El deposit_id es único por depósito y puede usarse para trazabilidad y conciliación.
• Depósitos en USD se acreditan en la cuenta comitente del usuario y pueden usarse directamente para operar Dólar MEP o FCI en dólares.

Puntos clave para recordar

1. El proceso es 100% asincrónico: no hay endpoint de confirmación, todo llega por webhook.
2. Implementar deposit_create es obligatorio para que tu plataforma se entere de que el saldo está disponible.
3. Usá deposit_id para deduplicación: procesá el evento de forma idempotente.
4. La identificación es por CUIT: el CBU de origen debe coincidir con el titular de la cuenta comitente.
5. Respondé HTTP 200 al webhook para evitar reintentos innecesarios.
6. El onboarding es prerequisito: sin investment_account_id activo, el depósito no puede ser asociado al usuario.