Validación de cuenta bancaria Chile

1. Introducción

El servicio de Validación de Cuenta Bancaria permite verificar que
una cuenta bancaria (persona natural o empresa) pueda recibir
transferencias correctamente.

La validación se realiza mediante el envío automático de una
transferencia de verificación por $1 CLP.
Este proceso confirma operativamente que:

La cuenta existe.
La cuenta puede recibir fondos.
Los datos bancarios ingresados son correctos.

Este servicio es especialmente útil para:

Procesos de portabilidad financiera.
Onboarding de beneficiarios.
Validación previa a realizar payouts masivos.
Reducción de rechazos por cuentas mal ingresadas.

2. Endpoint

POST /payouts/validate-account

3. Autenticación

Este endpoint requiere autenticación mediante el mecanismo estándar de
la API de Payout utilizando el token de floid que puede ser obtenido desde el dahsboard admin de floid. Consulte con su ejecutivo a cargo para mas información

4. Request

Payload requerido

{
  "beneficiary_id": "string",
  "beneficiary_account": "string",
  "beneficiary_account_type": "string",
  "beneficiary_bank_code": "string"
}

Campos

Campo	Tipo	Requerido	Descripción
beneficiary_id	string	Sí	RUT o identificador tributario del titular
beneficiary_account	string	Sí	Número de cuenta bancaria
beneficiary_account_type	string	Sí	Tipo de cuenta (ej: 1 = Cuenta Corriente)
beneficiary_bank_code	string	Sí	Código del banco receptor

5. Respuestas

Validación Exitosa -- HTTP 200

{
  "status": "validated",
  "validated": true,
  "beneficiary_account": "XXXXXX1234",
  "beneficiary_bank_code": "21",
  "validation_amount": 1,
  "validation_id": "VAL-2026-00001234",
  "message": "Cuenta validada exitosamente."
}

Validación Fallida -- HTTP 400 / 422

{
  "status": "failed",
  "validated": false,
  "error_code": "INVALID_ACCOUNT",
  "message": "La cuenta bancaria no pudo ser validada."
}

Validación fallida por servicio no disponible 400

{
  "status": "failed",
  "validated": false,
  "error_code": "SERVICE UNAVAIBLE",
  "message": "Error de servicio de validación"
}

6. Buenas Prácticas

Validar cuentas antes de habilitarlas para payouts masivos.
No realizar múltiples validaciones innecesarias sobre la misma
cuenta.
Manejar adecuadamente los estados de respuesta antes de permitir
dispersión de fondos.