Floid Developers Contáctanos

banco_persona.productos.consultar

Cuentas, tarjetas y líneas de crédito de una persona, con saldos y cupos.

Lectura Credencial bancaria de persona Ver ficha en JSON

Bancos

bcibicechilecoopeuchestadofalabellaitauripleysantanderscotiabanksecurity

Antes de usarla

  • Dos claves inválidas seguidas bloquean la credencial en Floid por 1 hora. Ante INVALID_CREDENTIALS no reintentes con la misma clave.

Parámetros

NombreTipoDescripción
bancorequerido texto Banco a consultar: bci, bice, chile, coopeuch, estado, falabella, itau, ripley, santander, scotiabank, security.
rut texto RUT del titular, con guion (12345678-9).
clave solo REST texto Clave del titular en la institución.
credencial_token texto Token de credencial guardada en Floid (por ejemplo, el que entrega el widget). Reemplaza rut y clave.
mostrar_campos objeto Filtra campos por grupo, por ejemplo {"accounts": "all", "cards": ["number", "type"], "lines": []}.
caseid texto Identificador del caso. Para pedir otra página de un resultado ya obtenido, repite el caseid de la primera respuesta.

Credenciales del titular: credencial_token (la única opción por MCP) o sus datos de acceso solo por REST desde tu backend. Cómo funcionan las credenciales.

Ejemplo

Con los datos de prueba del sandbox. En producción, quita /sandbox de la URL.

Argumentos de la herramienta MCP ejecutar

{
  "herramienta": "banco_persona.productos.consultar",
  "parametros": {
    "banco": "bci",
    "credencial_token": "<credencial_token>"
  }
}

Terminal

curl https://mcp.floid.app/sandbox/v1/ejecutar \
  -H "Authorization: Bearer $FLOID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "herramienta": "banco_persona.productos.consultar",
  "parametros": {
    "banco": "bci",
    "rut": "11111111-1",
    "clave": "1234"
  }
}'

Python

import os
import httpx

respuesta = httpx.post(
    "https://mcp.floid.app/sandbox/v1/ejecutar",
    headers={"Authorization": f"Bearer {os.environ['FLOID_TOKEN']}"},
    json={'herramienta': 'banco_persona.productos.consultar',
     'parametros': {'banco': 'bci', 'rut': '11111111-1', 'clave': '1234'}},
    timeout=300,
)
print(respuesta.json())

Respuesta

Respuesta del sandbox de Floid normalizada por la capa, recortada a dos elementos por lista.

{
  "data": {
    "products": {
      "accounts": [
        {
          "type": "corriente",
          "number": 12345678,
          "currency": "CLP",
          "balance": 10000,
          "line_balance": 10000
        },
        {
          "type": "vista",
          "number": 700654321,
          "currency": "CLP",
          "balance": 5000000
        }
      ],
      "cards": [
        {
          "number": "1234",
          "type": "credito",
          "name": "MasterCard",
          "CLP": {
            "total": 100000,
            "used": 0,
            "available": 100000
          },
          "USD": {
            "total": 3000,
            "used": 0,
            "available": 3000
          }
        },
        {
          "number": "4321",
          "type": "credito",
          "name": "MasterCard",
          "CLP": {
            "total": 100000,
            "used": 0,
            "available": 100000
          },
          "USD": {
            "total": 3000,
            "used": 0,
            "available": 3000
          }
        }
      ],
      "lines": [
        {
          "number": 123123131,
          "CLP": {
            "total": 600000,
            "used": 0,
            "available": 600000
          }
        }
      ]
    }
  },
  "meta": {
    "herramienta": "banco_persona.productos.consultar",
    "caseid": "xxxxx"
  }
}