santander) y distingues el tipo de titular con un
campo holder_type.
El
holder_type lo decides tú (el integrador) al emitir el widget_token
— no lo elige el usuario final. Tú sabes si estás onboardeando una persona o
una empresa. Si lo omites, es individual.Flujo de integración
Es el mismo flujo del widget, con un solo cambio: al emitir elwidget_token envías holder_type: "business". El widget se encarga del resto
(muestra el form correcto y filtra los bancos que soportan empresa).
1. (Opcional) Descubre qué bancos soportan empresa
GET /v1/institutions lista las instituciones con sus productos por
holder_type, y los campos de credenciales que pide cada una. Útil si quieres
armar tu propia UI de selección antes de abrir el widget.
credential_fields te dice exactamente qué campos pide el banco para ese
holder_type. El widget los renderiza solo; esto es para cuando quieres mostrar
el listado o el form tú mismo.
2. Emite el widget token con holder_type: "business"
3. Abre el widget (igual que siempre)
El frontend no cambia — elholder_type ya viajó en el token. El widget detecta
que es empresa y muestra los 3 campos (en vez de los 2 de personas):
4. Canjea el exchange token
Igual que en el flujo personal. Ellink resultante queda con
holder_type: "business" y su holder_id es el RUT de la empresa.
GET /v1/accounts?link_id=…, etc).
Disponibilidad
Hoy soportanholder_type: "business" Banco Santander Chile (Office
Banking), Banco de Chile (Portal Empresas), BCI (360Connect), Itaú
(Corporate), Scotiabank (Portal Empresas) y BancoEstado (BancoEstado
Empresas). Qué producto sincroniza cada una está en
Bancos soportados.
Consulta GET /v1/institutions?holder_type=business para ver en todo momento qué
bancos están disponibles para empresa y qué credenciales pide cada uno — cuando
sumemos otro, aparece ahí sin que cambies tu integración.