Banca empresa

Rail soporta cuentas de empresa además de las de personas. El modelo es el mismo que usa Fintoc: no hay una institución aparte para empresa — usas la misma institución (ej. santander) y distingues el tipo de titular con un campo holder_type.

`holder_type`	Para qué	Quién es el titular
`individual` (default)	Banca personal	La persona (su RUT)
`business`	Banca empresa	La empresa (RUT de la empresa)

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 el widget_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.

curl "https://api.rail.cl/v1/institutions?holder_type=business" \
  -H "Authorization: Bearer rail_pk_live_…"

{
  "object": "list",
  "data": [
    {
      "object": "institution",
      "id": "cl_santander",
      "country": "cl",
      "name": "Banco Santander Chile",
      "products": [
        {
          "name": "movements",
          "holder_type": "business",
          "credential_fields": [
            { "key": "rut_empresa", "label": "RUT empresa", "type": "rut" },
            { "key": "rut", "label": "RUT persona", "type": "rut" },
            { "key": "password", "label": "Clave portal web", "type": "password" }
          ]
        }
      ]
    }
  ]
}

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.

curl https://api.rail.cl/v1/widget_tokens \
  -X POST \
  -H "Authorization: Bearer rail_sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "holder_type": "business",
    "institution_id": "cl_santander"
  }'

institution_id es opcional. Si lo envías, el widget abre directo en ese banco. Si no, el widget muestra el picker filtrado a los bancos que soportan empresa (no aparecen los de solo-personas ni los marcados “Pronto”).

El frontend no cambia — el holder_type ya viajó en el token. El widget detecta que es empresa y muestra los 3 campos (en vez de los 2 de personas):

Campo	Qué es
RUT empresa	RUT de la empresa (es el titular del link)
RUT persona	RUT del usuario que ingresa al portal
Clave portal web	La clave de ese usuario

<script src="https://widget.rail.cl/v1/embed.js"></script>
<script>
  Rail.openWidget({
    token: 'wt_…',          // emitido con holder_type: "business"
    publishableKey: 'rail_pk_live_…',
    onSuccess: (et) => {
      fetch('/api/rail-callback', {
        method: 'POST',
        body: JSON.stringify({ exchange_token: et }),
      });
    },
  });
</script>

4. Canjea el exchange token

Igual que en el flujo personal. El link resultante queda con holder_type: "business" y su holder_id es el RUT de la empresa.

{
  "object": "link",
  "id": "link_8a2f4c6e1b9d5037",
  "bank_id": "santander",
  "holder_type": "business",
  "holder_id": "76.543.210-3",
  "status": "active"
}

De acá en adelante, lees cuentas y movimientos exactamente igual que con un link personal (GET /v1/accounts?link_id=…, etc).

Disponibilidad

Santander Empresa (Office Banking) está en habilitación temprana. Puedes integrar el flujo y tus usuarios pueden ingresar credenciales hoy, pero la sincronización de cuentas/movimientos para empresa se está terminando de activar. Consulta GET /v1/institutions?holder_type=business para ver en todo momento qué bancos están disponibles para empresa — cuando sumemos otro, aparece ahí sin que cambies tu integración.

Empezar

Conceptos

Guías

Banca empresa

Flujo de integración

1. (Opcional) Descubre qué bancos soportan empresa

2. Emite el widget token con `holder_type: "business"`

3. Abre el widget (igual que siempre)

4. Canjea el exchange token

Disponibilidad

​Flujo de integración

​1. (Opcional) Descubre qué bancos soportan empresa

​2. Emite el widget token con holder_type: "business"

​3. Abre el widget (igual que siempre)

​4. Canjea el exchange token

​Disponibilidad

Flujo de integración

1. (Opcional) Descubre qué bancos soportan empresa

2. Emite el widget token con `holder_type: "business"`

3. Abre el widget (igual que siempre)

4. Canjea el exchange token

Disponibilidad