Saltar al contenido principal

​
Qué vas a construir

Cada cliente (o cada orden) recibe su propio Account Number (CLABE en México). Cuando llega dinero a ese Account Number, Fintoc te envía un webhook con la metadata que adjuntaste cuando lo creaste, para que sepas al instante qué cliente pagó, sin necesidad de parsear estados de cuenta ni cruzar montos.

​
Cuándo usarlo

  • Cuotas de créditos, primas de seguros, suscripciones SaaS.
  • Cualquier flujo con clientes identificables que te pagan de manera recurrente.
  • Marketplaces donde cada comprador necesita un lugar estable para depositar.

​
Cómo funciona

​
¿Una CLABE por cliente o una por orden?

Ambos patrones están soportados. Una por orden es el modelo de conciliación más sólido: deshabilita o elimina la CLABE en cuanto se pague la orden para prevenir pagos dobles.

​
Checklist de implementación

  1. Crea el Account Number con metadata. Consulta Recibir transferencias → Crear un Account Number.
  2. Maneja el webhook. Suscríbete a transfer.inbound.succeeded; lee data.account_number.metadata. Referencia del payload: Recibir transferencias → Payload de webhook.
  3. Refuerza con reglas de negocio. Configura options.min_amount / max_amount para rechazar automáticamente montos incorrectos, y deshabilita la CLABE después del pago. Consulta Agrega lógica a los Account Numbers.
  4. Limpia los Account Numbers que no uses a medida que los clientes se dan de baja o se cierran las órdenes. Consulta Administra tus Account Numbers. Puedes tener hasta 1,000,000 de Account Numbers. Si has creado Account Numbers que ya no usas, deshabilítalos o elimínalos. Los Account Numbers obsoletos siguen aceptando transferencias, lo que puede contaminar tu conciliación y tus estados de cuenta.