Introducción
Tus clientes aceptan los términos de Allaria en una landing que hospeda Allaria. Vos pedís un enlace de un solo uso servidor a servidor, redirigís al cliente ahí, y esa aceptación es la constancia que Allaria guarda de la firma.
Esta sección documenta una integración específica de Banco del Sol y requiere el rol BANCO_DEL_SOL_VIEWER. No compartas enlaces a estas páginas fuera de la integración.
Integrá contra desarrollo: hoy el flujo corre ahí de punta a punta.
- Producción todavía se está aprovisionando — las credenciales de este endpoint no existen aún. Una llamada a producción no va a funcionar hasta que Allaria avise que está lista.
- Consultá a integraciones@allaria.com.ar antes de agendar una salida a producción.
Para quién es esta sección
Este es el paso de consentimiento del flujo de cuenta: produce la constancia de que la persona aceptó un documento, y nada más. La apertura de la cuenta en sí, y todo lo que viene después, está en Apertura de cuentas.
Del lado tuyo hay dos llamadas: la que pide un enlace y, cuando la necesites, la que pregunta si alguien ya firmó. La página que lee el cliente, la aceptación y la constancia son del lado de Allaria.
Requisitos previos
El enlace se emite a través del gateway b2b, así que la llamada se autentica como cualquier otra: tu IP whitelisteada y un access token obtenido con tu client_id / client_secret. Ver Primeros pasos.
Además, tus credenciales tienen que estar autorizadas específicamente para este endpoint. Un token que funciona en otro lado pero responde 403 acá significa que falta esa autorización: escribinos a integraciones@allaria.com.ar.
Los dos tipos de enlace
Un enlace lleva a una de dos pantallas, y son excluyentes. Cuál corresponde lo elegís vos al pedir el enlace, porque sólo vos sabés si la persona ya tiene cuenta en Allaria.
kind | Para quién es | Qué acepta la persona | Qué pasa después |
|---|---|---|---|
TYC | Alguien que está abriendo una cuenta | Los términos y condiciones, que ya incluyen la vinculación de BYMA adentro del texto | La apertura sigue su curso normal |
VINCULATION | Alguien que ya tiene cuenta | La vinculación de BYMA de una de sus cuentas, que elige en la pantalla, y nada más | Allaria vincula esa cuenta en BYMA después, no en el momento de aceptar, y ahí termina el flujo |
Un enlace VINCULATION además necesita el CUIT de la persona: esa pantalla lista los comitentes que ya tiene, Allaria los busca por CUIT, y la persona elige uno para vincular.
No hay un tercer caso ni un checkbox. En un enlace TYC la vinculación es parte del texto que se firma; en uno VINCULATION no hay términos que firmar, y aceptar esa pantalla es la conformidad de la vinculación.
El flujo
Llamá a Emitir enlace con el DNI, nombre y apellido de la persona, y el kind. Recibís una URL y la cantidad de segundos que sigue siendo válida.
Hacelo en el momento. La ventana de vencimiento empieza cuando se emite el enlace, no cuando el cliente lo abre. Un enlace emitido con anticipación y mandado por mail probablemente llegue vencido.
En la landing de Allaria. No hay nada que construir de tu lado. Aceptar consume el enlace.
La constancia guarda qué documento se aceptó, cuándo y desde qué IP. Es la evidencia de la firma.
TYC: la apertura de cuenta se está conectando para leerla. Hasta que eso esté terminado, la constancia se guarda pero todavía no hace avanzar la cuenta por sí sola.VINCULATION: aceptar además deja encolada la vinculación de la cuenta que eligió la persona. Allaria la completa en BYMA de forma asíncrona, con reintentos si BYMA no responde, así que en el momento de aceptar la cuenta todavía no está vinculada.
Esa constancia la podés leer cuando quieras con Consultar firma, por documento, así decidir si mandás a alguien por este flujo no depende de que hayas guardado algo del paso 1.
El enlace
https://apertura-cuenta.allaria.com.ar/banco-del-sol/kJ3nQ7pXr2vB8sLmT4wYd6ZaE1cH0gNfUiOjRkPq5tM
Usá la url tal cual viene: no la rearmes a partir del token ni asumas que el path se mantiene igual.
- Un solo uso. Una vez aceptado, el enlace está consumido. Volver a abrirlo le muestra al cliente que ya aceptó, que es la pantalla correcta y no un error.
- Vence.
expires_in_secondstrae la ventana; son 30 minutos en producción y más en desarrollo. Leela de la respuesta en vez de hardcodearla: si alguna vez cambia, tu integración acompaña. - Un enlace vivo por persona. Pedir un enlace nuevo retira el que esa persona tuviera sin usar. El viejo pasa a decirle que fue reemplazado.
Cualquiera que tenga esa URL puede aceptar los términos en nombre de esa persona hasta que se consuma.
- Mandala por el canal por el que ya autenticás al cliente.
- No la loguees, y no la dejes en ningún lado donde la pueda leer otro.
Después de que el cliente acepta, te contesta la landing, no esta API
Dos cosas te llegan una vez que la persona firmó, y las dos vienen de la landing: el aviso de que aceptó, y a dónde se manda al cliente después.
Ninguna de las dos pasa por esta API. La llamada que hacés vos termina cuando recibís el enlace:
- no hay callback desde este endpoint;
- no hay un estado que puedas pollear;
- no hay una
return_urlen el request.
Tampoco hay nada que configurar por cliente: las dos se acuerdan una vez con el equipo de la landing, no se mandan en cada llamada.
Fallas más comunes
| Síntoma | Causa |
|---|---|
401 invalid token | Access token vencido o mal formado. Pedí uno nuevo — ver Autenticación. |
403 client not allowed to issue links | El token es válido pero tu client_id no está autorizado para este endpoint. |
422 invalid_payload | Algún campo del payload no validó. El array problems nombra todos los campos que fallaron, no sólo el primero. |
| El cliente ve "el enlace venció" | Pasó demasiado tiempo entre la emisión del enlace y el momento en que el cliente lo abrió. Emitilo justo antes de redirigir. |
| El cliente ve "el enlace fue reemplazado" | Se emitió un enlace más nuevo para el mismo DNI. Pedí de a uno, no un lote por adelantado. |
| El cliente ve "ya aceptaste" | El enlace ya se usó — típicamente el cliente refrescó la página después de firmar. Es éxito, no una falla. |