GET /v1/institutions — consúltala para armar tu UI de selección de banco; cuando sumamos una institución nueva aparece ahí sin que cambies tu integración.
El
bank_id es el identificador que pasas al crear un link o emitir un widget_token. El id de institución (cl_<bank_id>) es el que devuelven los recursos de la API.Instituciones
Todas devuelven montos en CLP (Santander empresa incluye además USD). El histórico por defecto es de 60–90 días; con
refresh_type: "historical" en el refresh_intent se amplía la ventana donde el banco lo permite.
Comportamientos a tener en cuenta
BancoEstado tiene login asíncrono: puede tardar 60–90 segundos en detectar una clave incorrecta. Si tu usuario reporta que la conexión “se queda pegada”, espera al menos 90s antes de asumir error.
Mercado Pago se autentica con correo (no RUT) y su validación es multi-paso (código por WhatsApp / escaneo de QR). El widget renderiza el formulario correcto según la institución.
Sandbox
En test mode, todas las instituciones funcionan con las credenciales mágicas (RUT11.111.111-1 + clave rail-sandbox) y devuelven data fake determinista — sin tocar el banco real. El bank_id que elijas es cosmético en sandbox.
Banca empresa
Las cuentas de empresa no son unbank_id aparte: usas la misma institución y la distingues con holder_type: "business" al emitir el widget_token. Mismo modelo que Fintoc — ver Banca empresa.
Consulta
GET /v1/institutions?holder_type=business para ver en todo momento qué instituciones soportan empresa y qué credenciales pide cada una (credential_fields).Consultar disponibilidad en runtime
GET /v1/institutions lista las instituciones soportadas, sus productos por holder_type y los campos de credenciales que pide cada una. Filtra con ?holder_type= y ?product=.
individual vs business, y qué campos pedir en cada una).