Floid Developers Contáctanos

pagos.cuenta_pe.validar

Titular y banco de una cuenta interbancaria (CCI) de Perú antes de pagarle. Con documento o nombre, responde validation true o false.

Lectura Sin credenciales del titular Ver ficha en JSON

Antes de usarla

  • El documento del titular vuelve enmascarado.

Parámetros

NombreTipoDescripción
moneda requerido entero Moneda de la cuenta: 1 soles, 2 dólares.
Valores: 1 2
cci requerido texto CCI de 20 dígitos.
numero_cuenta texto Número de cuenta, para cuentas BCP.
documento texto DNI, carné de extranjería o RUC del titular, para verificarlo.
tipo_documento entero 1 DNI, 2 carné de extranjería, 9 RUC.
Valores: 1 2 9
nombre texto Nombre del titular, para verificarlo.
banco_cuenta texto Nombre del banco de la cuenta, para verificarlo.
caseid texto Identificador del caso. Para pedir otra página de un resultado ya obtenido, repite el caseid de la primera respuesta.

Ejemplo

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

Argumentos de la herramienta MCP ejecutar

{
  "herramienta": "pagos.cuenta_pe.validar",
  "parametros": {
    "moneda": 1,
    "cci": "<cci>"
  }
}

Terminal

curl https://mcp.floid.app/sandbox/v1/ejecutar \
  -H "Authorization: Bearer $FLOID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "herramienta": "pagos.cuenta_pe.validar",
  "parametros": {
    "moneda": 1,
    "cci": "<cci>"
  }
}'

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': 'pagos.cuenta_pe.validar',
     'parametros': {'moneda': 1, 'cci': '<cci>'}},
    timeout=300,
)
print(respuesta.json())

Respuesta

Siempre {"data": …, "meta": {"herramienta", "caseid"}}, o {"error": …, "meta": …} si algo falla. Formato de respuestas.