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
| Nombre | Tipo | Descripció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.