Introducción

Todas las APIs de Allaria — bursátil, billetera, onboarding, apertura de cuentas — se consumen a través del mismo gateway y se protegen de la misma forma.

Esta sección es el punto de entrada de cualquier integración. Explica:

• cómo se otorga el acceso;
• cómo obtener un token;
• qué sección de producto leer después.

Base URLhttps://b2b.allaria.dev

Todos los endpoints documentados en este sitio cuelgan de esta base URL. Hay una base URL por ambiente (desarrollo y producción); la que se muestra arriba corresponde al ambiente para el que se compiló este sitio.

Cómo funciona el acceso

El acceso se otorga en tres capas independientes. Las tres tienen que estar dadas para que un request funcione.

Capa	Qué controla	Cómo se otorga	Síntoma cuando falta
Red	Qué direcciones IP pueden llegar al gateway	Allaria whitelistea las IPs públicas de salida de tu integración — ver Acceso	El request expira por timeout, sin código de estado HTTP
Identidad	Quién sos	Un par client_id / client_secret emitido para tu empresa, que se intercambia por un token — ver Autenticación	401 invalid_client
Autorización	Qué productos y endpoints pueden usar tus credenciales	Permisos asociados a tu client_id cuando se da de alta tu integración	403 en un endpoint que por lo demás funciona

Un 403 en un endpoint puntual mientras el resto de tu integración funciona significa que tus credenciales no tienen habilitado ese producto.

Solicitalo a integraciones@allaria.com.ar — no es algo que puedas habilitar por tu cuenta.

Modelo de autenticación

Allaria usa el grant client_credentials de OAuth 2.0. Es un flujo server-to-server: tu backend se autentica como tu empresa, no como un usuario final. No hay pantalla de login, ni redirect, ni refresh token.

• Las credenciales se emiten por empresa y por ambiente. Las credenciales de desarrollo no funcionan en producción.
• El token es un token Bearer, válido por 24 horas (expires_in: 86400).
• Pedí un token nuevo cuando el actual expira — reutilizar un token expirado devuelve 401.
• El client_secret nunca debe salir de tu backend. Ver la nota de seguridad en Autenticación.

Primeros pasos

1

Solicitá credenciales y whitelisting

Contactá a integraciones@allaria.com.ar con:

• los datos de tu empresa;
• las direcciones IP públicas desde las que va a llamar tu integración;
• los productos que necesitás integrar.

Recibís un client_id y un client_secret por ambiente.

Detalle: Acceso.

2

Obtené un access token

Intercambiá tus credenciales por un access_token en POST /auth/token y envialo como Authorization: Bearer <access_token> en cada request posterior.

Detalle: Autenticación.

3

Andá a tu sección de producto

Qué endpoints llamás después depende de qué hace tu empresa. Ver la tabla de abajo.

¿Recién arrancás con el mercado de capitales argentino, o no tenés claro qué es un comitente, un CVU o el MEP? Empezá por el Glosario — también tiene la tabla de qué identificador de cuenta espera cada familia de endpoints.

Qué sección te corresponde

Tu situación	Sección	Qué proveemos
Traés clientes finales a Allaria pero tu empresa no es sujeto obligado, por lo que no estás autorizado a recolectar y transmitir sus datos personales por tu cuenta	Onboarding	Un onboarding completo — frontend y backend — junto con la API para realizar la apertura de la cuenta. Allaria hace la verificación de identidad y se hace responsable del KYC.
Tu empresa sí es sujeto obligado y ya realiza su propia debida diligencia del cliente	Aperturas	Allaria abre las cuentas sobre la base de tu propia verificación, por lo que no hace falta el flujo de onboarding.
Operás como integración de ALyC: órdenes, posiciones, movimientos, market data, MEP, fondos comunes de inversión	Allaria	La superficie de API bursátil: órdenes, posiciones, movimientos, MEP, fondos, planes de ahorro, datos de mercado.
Integrás la billetera Allaria+: cuentas, transferencias, web checkout	Allaria+	La superficie de API de la billetera: cuentas, transferencias, web checkout.
Sos un PSP y querés que los saldos de tus clientes rindan en un fondo común de inversión de Allaria	Allaria › Servicios para PSPs	Un flujo end-to-end: suscripciones y rescates en lote para el rango de cuentas que te asignamos, más tenencias, cotizaciones y totales diarios para conciliar.

¿Onboarding o Aperturas?

Los dos terminan con una cuenta abierta en Allaria, pero responden a posiciones regulatorias distintas — según tu empresa sea o no sujeto obligado ante la UIF. Los dos caminos no son intercambiables.

¿No tenés certeza de cuál le corresponde a tu empresa? Consultá a integraciones@allaria.com.ar antes de empezar a desarrollar.