Introducción
La API de Onboarding le permite a tu empresa abrir una cuenta Allaria o Allaria+ en nombre de uno de tus clientes finales, siendo Allaria quien realiza la verificación de identidad y la debida diligencia del cliente.
Vos recolectás los datos y documentos del cliente desde tu propio producto, los enviás a través de esta API y Allaria hace la revisión de KYC/AML y crea la cuenta.
Para quién es esta sección
Empresas que no son sujetos obligados: no están inscriptas ante la UIF, así que no pueden recolectar y transmitir datos personales de sus clientes para abrir cuentas por cuenta propia.
Allaria sí es sujeto obligado. Cuando los datos del cliente pasan por esta API, la obligación de verificación y la responsabilidad por la revisión de KYC quedan en Allaria y no en vos.
Ese es el sentido del flujo: es la manera en que una empresa no obligada incorpora clientes a una cuenta regulada.
Las consecuencias prácticas:
- El modelo de datos lo dicta la regulación, no la conveniencia. La cantidad de campos requeridos, los documentos, el cuestionario y el desglose de accionistas existen porque un sujeto obligado debe recolectarlos. No se pueden recortar.
- La aprobación no es inmediata. Cargar un onboarding inicia una revisión. El resultado es
APPROVEDoREJECTED, y te enterás consultando el estado. - Los valores deben coincidir exactamente con los catálogos de Allaria. Países, provincias, actividades y preguntas del cuestionario no son texto libre — ver Datos de referencia.
No uses esta sección — abrí las cuentas a través de Aperturas. Allaria abre la cuenta sobre la base de tu propia debida diligencia, sin repetir este flujo.
¿No tenés certeza de cuál te corresponde? Consultá a integraciones@allaria.com.ar antes de desarrollar.
Qué obtenés al final
Un onboarding completado produce una o más cuentas, cada una con:
- su propio identificador;
- un
type:ALLARIA,ALLARIAMASoALLARIAMAS_INTERNAL; - un
cvu, en las cuentas de billetera.
A partir de ahí, el cliente se opera a través de las APIs de Allaria o Allaria+, no desde esta sección.
Prerrequisitos
Todos los endpoints de esta sección requieren autenticación. Antes de tu primera llamada necesitás tu IP whitelisteada y un access token — ver Primeros pasos.
El flujo
POST /v1/onboardings abre el proceso y retorna un onboarding_id. Acá declarás dos cosas que después no se pueden cambiar:
company_type— en qué empresa se abre la cuenta:ALLARIA(bursátil) oALLARIAMAS(billetera).onboarding_type—INDIVIDUALpara una persona humana,BUSINESSpara una persona jurídica. Esto define qué campos y qué documentos se requieren en los pasos siguientes.
La respuesta trae además un ttl: el timestamp Unix (en segundos) en el que vence el onboarding, 60 días después de creado. Comparalo contra la hora actual — es un instante, no una cuenta regresiva. Una vez vencido, creá un onboarding nuevo.
POST /v1/onboardings/{onboarding_id}/documents no recibe el archivo:
- Llamalo justo antes de subir; retorna una URL prefirmada.
- Hacé un
PUTdel archivo directamente contra esa URL antes de que venza — hoy, 600 segundos (10 minutos). Tomá la ventana deexpires_in_secondsen vez de hardcodear 600, por si cambia.
Qué documentos se requieren depende del onboarding_type (listado completo en la página del endpoint):
INDIVIDUAL: las dos caras del DNI y una declaración de patrimonio.BUSINESS: documentación societaria — estatuto, autoridades, libro de accionistas, notas de socios/accionistas, etc.
Antes de armar el body de carga, consultá los endpoints de Datos de referencia. Países, provincias, actividades económicas y preguntas del cuestionario deben enviarse con los valores exactos que retorna Allaria.
PUT /v1/onboardings/{onboarding_id} envía todo el conjunto de datos en una sola llamada: las personas involucradas, las respuestas al cuestionario y la aceptación de términos y condiciones. Es el request más grande del flujo y el que más depende del onboarding_type.
En un BUSINESS, "las personas involucradas" no es solo la empresa: también se declaran representantes y accionistas, cada uno con su propio registro de persona.
Cargar los datos cierra la etapa de carga y pasa el onboarding a revisión.
GET /v1/onboardings — para el listado completo — o GET /v1/onboardings/{onboarding_id} para uno solo. El onboarding queda en PENDING hasta que termina la revisión, y después pasa a APPROVED o REJECTED.
APPROVED no significa que las cuentas ya sean operables. Revisá el state de cada cuenta del array accounts:
COMPLETED— la cuenta está lista. Es el único estado que lo indica.PENDING_MANUAL_INPUT— un operador de Allaria tiene que intervenir; no hay nada que reintentar de tu lado.
Datos de referencia
Los cuatro endpoints de Datos de referencia son catálogos de solo lectura. No son pasos del flujo — se consultan cuando necesitás armar un body de carga válido, y sus valores cambian con la frecuencia suficiente como para poder cachearlos.
| Endpoint | Alimenta estos campos en Cargar onboarding |
|---|---|
| Obtener preguntas | El array questions — cada respuesta debe citar el texto de la pregunta exactamente como lo retorna el endpoint |
| Obtener países | citizenship, birth_country, country, registration_country |
| Obtener provincias | state, registration_province — toma el código ISO Alpha-2 del país de Obtener países |
| Obtener actividades | activities, separadas por tipo de persona (PHYSICAL / JURIDICAL) |
Enviar un valor que no esté en estos catálogos falla la validación con 422.
Individual vs. Business de un vistazo
INDIVIDUAL | BUSINESS | |
|---|---|---|
| A quién se onboardea | Una persona humana | Una persona jurídica, más sus representantes y accionistas |
| Personas en la carga | Una | Varias — la entidad, cada representante, cada accionista |
| Documentos | DNI (frente y dorso), declaración de patrimonio | Estatuto, acta de autoridades, libro de accionistas, notas de socios/accionistas, balance y otros según el tipo de entidad |
| Actividades | Se consultan con type=PHYSICAL | Se consultan con type=JURIDICAL para la entidad y type=PHYSICAL para las personas |
Errores frecuentes
| Síntoma | Causa |
|---|---|
404 al subir un documento o al cargar los datos | El onboarding_id no existe, o venció el ttl del onboarding — creá uno nuevo |
422 al cargar los datos | Falta un valor, o un valor no coincide con un catálogo de datos de referencia |
403 en todos los endpoints de esta sección | Tus credenciales no están autorizadas para onboarding — contactá a integraciones@allaria.com.ar |
| El request expira por timeout, sin código de estado | Tu IP no está whitelisteada — ver Acceso |