> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yafacture.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Validación de cuentas CLABE

> Confirma que una cuenta CLABE existe y obtén el nombre real del titular con la prueba del centavo

## ¿Qué es la validación de cuentas?

Antes de enviar dinero a una cuenta que no conoces, puedes verificar que la **CLABE interbancaria existe** y conocer el **nombre real del titular** y el **banco** registrados ante el sistema SPEI. Yafacture lo hace mediante la **prueba del centavo**: se envía una transferencia de **\$0.01 MXN** a la cuenta y, con la respuesta del banco receptor, se confirma la identidad del titular o se detecta que la cuenta no es válida.

Encuentras esta función en **Billetera → Validar cuentas**.

<Info>
  Cada validación cuesta **\$0.01 MXN**, que se descuenta del saldo de tu billetera. Las cuentas con una validación vigente se resuelven desde la cache **sin costo**.
</Info>

***

## Cómo funciona la prueba del centavo

<Steps>
  <Step title="Se envía $0.01 a la cuenta">
    Yafacture genera una transferencia SPEI de un centavo desde tu cuenta origen hacia la CLABE a validar.
  </Step>

  <Step title="El banco receptor responde">
    Si la cuenta existe, la transferencia se **liquida** y el banco devuelve el nombre real del titular. Si no existe o no puede recibir, la transferencia se **devuelve** con el motivo del rechazo.
  </Step>

  <Step title="Se guarda el resultado">
    El resultado queda guardado con una **vigencia configurable** (3 días por defecto). Mientras la validación esté vigente, consultar la misma cuenta no genera un nuevo centavo.
  </Step>
</Steps>

<Tip>
  La respuesta del banco suele llegar en **segundos**, aunque en algunos casos puede tardar varios minutos. La pantalla se actualiza automáticamente mientras la validación está en curso.
</Tip>

***

## Validar una cuenta individual

Ingresa la **CLABE de 18 dígitos** en el campo **Cuenta CLABE** y presiona **Consultar**.

* Si la cuenta ya tiene una **validación vigente**, verás de inmediato el titular, el banco y el estado, sin costo.
* Si no hay validación vigente, aparece el botón **Validar cuenta (\$0.01)** para iniciar la prueba del centavo.

### Estados de una validación

| Estado               | Significado                                                                               |
| -------------------- | ----------------------------------------------------------------------------------------- |
| **Validando...**     | El centavo fue enviado y se espera la respuesta del banco receptor                        |
| **Cuenta validada**  | La cuenta existe; se muestra el nombre del titular y el banco                             |
| **Cuenta no válida** | La transferencia fue devuelta; se muestra el motivo (cuenta inexistente, bloqueada, etc.) |
| **Error**            | Ocurrió un error al procesar la validación                                                |

***

## Validación masiva con Excel

Para validar muchas cuentas de una sola vez, sube un archivo Excel con el layout de Yafacture:

<Steps>
  <Step title="Descarga la plantilla">
    Presiona **Descargar plantilla** para obtener el archivo Excel. Llena la columna **CUENTA\_CLABE** con una cuenta por fila.
  </Step>

  <Step title="Sube el archivo">
    Arrastra o selecciona el archivo en el área de carga. Yafacture revisa cada fila: la CLABE debe tener **18 dígitos**, contener **solo números** y tener el **dígito verificador correcto**. Las filas inválidas se muestran con su motivo y las cuentas repetidas se deduplican.
  </Step>

  <Step title="Confirma la validación">
    Presiona **Validar cuentas** y revisa el resumen en la ventana **Confirmar validación**: número de cuentas y **costo estimado**. Las cuentas con validación vigente se resuelven de la cache sin costo; solo las nuevas o vencidas generan la transferencia de \$0.01.
  </Step>
</Steps>

<Warning>
  Al crear el lote se verifica que tu **saldo disponible** alcance para cubrir todas las validaciones. Si el saldo no es suficiente, el lote se rechaza y las filas que no alcanzaron a enviarse se marcan como **Sin saldo**.
</Warning>

### Seguimiento del lote

Cada archivo subido aparece en el **historial** con su estado. Al abrir un lote verás el detalle por cuenta:

| Estado del lote                          | Significado                                                  |
| ---------------------------------------- | ------------------------------------------------------------ |
| **Pendiente**                            | El lote está en cola para procesarse                         |
| **Enviando validaciones...**             | Se están enviando los centavos de cada fila                  |
| **Esperando respuesta de los bancos...** | Todos los centavos fueron enviados; faltan respuestas        |
| **Completado**                           | Todas las cuentas tienen resultado                           |
| **Rechazado**                            | El lote no pudo procesarse (por ejemplo, saldo insuficiente) |

Dentro del lote, cada fila muestra la **Cuenta CLABE**, el **Titular**, el **Banco** y su estado individual: **Validada**, **Validada (cache)**, **No válida**, **Sin saldo** o **Error**.

<Info>
  Si subes el **mismo archivo** dos veces, Yafacture lo detecta y no vuelve a cobrar: te muestra el lote ya existente en lugar de crear uno nuevo.
</Info>

***

## Vigencia y cache de validaciones

El resultado de cada validación se guarda por emisor con una vigencia configurable:

* En **Ajustes → Configuración → Principal → Billetera** encuentras el campo **"Días de vigencia de validación de cuentas CLABE"** (3 días por defecto). Pasados esos días, validar la misma cuenta vuelve a generar la transferencia de \$0.01.
* El botón **"Invalidar cache de validaciones"** anula todas las validaciones vigentes (previa confirmación), de modo que la siguiente consulta de cualquier cuenta vuelva a ejecutar la prueba del centavo. Útil si necesitas re-verificar titulares recientes.

***

## Notificaciones

Yafacture te avisa por el centro de **mensajes** cuando:

* Una cuenta resulta **inexistente o devuelta**, o la validación termina en **error**.
* Un **lote** de validación masiva se completa (con el resumen de resultados).

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Cuánto cuesta validar una cuenta?">
    **\$0.01 MXN** por cuenta, que se descuenta de tu saldo en la billetera. Consultar una cuenta con validación vigente no tiene costo.
  </Accordion>

  <Accordion title="¿Me regresan el centavo?">
    Si la cuenta **no existe**, la transferencia se devuelve y el centavo regresa a tu saldo. Si la cuenta **sí existe**, el centavo se liquida en la cuenta del titular como parte de la verificación.
  </Accordion>

  <Accordion title="¿Cuánto tiempo es válido el resultado?">
    Los días configurados en **Configuración → Billetera** (3 por defecto). Durante ese periodo, consultar la misma cuenta devuelve el resultado guardado sin costo.
  </Accordion>

  <Accordion title="¿Qué significa 'Cuenta no válida'?">
    El banco receptor devolvió la transferencia. El motivo aparece junto al estado: cuenta inexistente, cuenta bloqueada, entre otros. Verifica la CLABE con el titular antes de intentar un pago.
  </Accordion>

  <Accordion title="¿Por qué una fila aparece como 'Sin saldo'?">
    Tu saldo se agotó antes de enviar el centavo de esa fila. Recarga tu billetera y vuelve a subir el archivo: las cuentas ya validadas se resolverán de la cache sin costo y solo se enviarán las pendientes.
  </Accordion>

  <Accordion title="¿Puedo validar la misma cuenta desde dos lotes al mismo tiempo?">
    Sí, pero solo se envía **un** centavo: si ya hay una validación en curso para esa cuenta, ambas consultas esperan la misma respuesta del banco.
  </Accordion>
</AccordionGroup>

***

<CardGroup cols={2}>
  <Card title="Transferencias SPEI" icon="paper-plane" href="/pagos-cobros/transferencias">
    Envía dinero a las cuentas que ya validaste, de forma individual o masiva.
  </Card>

  <Card title="Movimientos" icon="clock-rotate-left" href="/pagos-cobros/movimientos">
    Consulta el historial de transferencias y órdenes de tu billetera.
  </Card>
</CardGroup>