Saltar al contenido principal
Solo en México.

Qué vas a construir

Antes de enviar un payout, Fintoc envía un microdepósito de 0.01 MXN a la CLABE (cuenta bancaria estandarizada mexicana) de destino. El comprobante devuelve el nombre del titular y su RFC (identificación fiscal mexicana). Puedes comparar estos valores con la información que ingresó tu usuario. Esta verificación te ayuda a detectar errores de tipeo y evaluar al titular de destino contra tus reglas de cumplimiento.

Cuándo usarlo

Usa esta verificación en estos flujos:
  • Retiros a una CLABE ingresada por el usuario.
  • Transferencias P2P a una CLABE ingresada por el usuario.
  • Onboarding de proveedores y alta de vendedores en marketplaces.
  • Cualquier payout donde una transferencia mal dirigida sea difícil de revertir, como una liquidación a un proveedor o un retiro único.

Cómo funciona

La verificación se ejecuta en cinco pasos y usa una firma JSON Web Signature (JWS):

Checklist de implementación

  1. Crea la verificación. Consulta Verifica CLABEs para conocer los detalles de la API y el cuerpo de la solicitud.
  2. Compara los campos del titular. Usa fuzzy matching sobre holder_name para tener en cuenta variantes del nombre. Usa holder_id (RFC) como una señal más estricta.
  3. Cachea el resultado. La información del titular es estable para cada CLABE. Puedes verificar la CLABE durante el onboarding y reutilizar el resultado en payouts posteriores a la misma cuenta.

Prueba la integración

En modo test, verifica una CLABE de prueba publicada y confirma que el webhook incluye los campos del titular:
  • Usa tu llave secreta de prueba (sk_test_...) y la CLABE de prueba 000000000000000000.
  • Espera un objeto account_verification en estado pending en la respuesta inicial, con holder_name y holder_id todavía en null.
  • Espera un webhook account_verification.succeeded con los campos holder_name y holder_id completos dentro de counterparty. Consulta Verifica CLABEs para ver el payload completo. Consulta Prueba tu integración para conocer las CLABEs de prueba disponibles.