Saltar al contenido principal

​
Qué vas a construir

Un sistema donde cada uno de tus usuarios finales tiene su propio saldo, sus propios Account Numbers para recibir dinero y un historial de movimientos limpio. El bloque básico para neobancos, marketplaces que mantienen saldos de vendedores, apps para trabajadores gig y cualquier cosa donde “saldo del usuario” sea un concepto de primera clase.

​
Cuándo usarlo

  • Neobancos y aplicaciones fintech.
  • Plataformas B2B que mantienen fondos de clientes.
  • Marketplaces o plataformas gig donde los vendedores acumulan ganancias antes de retirarlas.

​
Tres patrones — elige uno

Tienes tres formas de modelar el “wallet de usuario” sobre Fintoc, de la más simple a la más rica. Empieza con la más simple que te sirva.

​
Patrón A — Un Account Number por usuario (Account Numbers virtuales)

  • Estructura: una Account de Fintoc (la tuya) con muchos Account Numbers, uno por usuario.
  • Saldo por usuario: lo llevas en tu propia base de datos. Fintoc mantiene el agregado.
  • KYB: ninguno por usuario, solo se onboardea tu Entidad raíz.
Configuración:
  1. Usa tu cuenta raíz.
  2. Crea un Account Number por usuario con metadata.user_id.
  3. En transfer.inbound.succeeded, acredita el saldo del usuario en tu base de datos.
  4. Para los retiros, crea una Transferencia saliente desde tu cuenta raíz y debita el saldo del usuario en tu base de datos.
Bueno para: wallets ligeras, ganancias, depósito/retiro simples.

​
Patrón B — Una Account por usuario bajo tu Entidad (subcuentas)

  • Estructura: muchas Accounts, todas bajo tu Entidad. Cada una tiene su propio saldo y su propio Account Number raíz.
  • Saldo por usuario: Fintoc lo lleva a nivel de Account. Visible en el Dashboard y en los estados de cuenta.
  • KYB: ninguno por usuario.
Configuración:
  1. POST /v2/accounts con el ID de tu Entidad. La Account se crea al instante con un Account Number raíz.
  2. En transfer.inbound.succeeded, usa data.account_id para identificar al usuario.
  3. Los retiros usan ese account_id como fuente de fondos.
Bueno para: wallets donde quieres que Fintoc lleve los saldos por usuario. Funciona en MX y CL.

​
Patrón C — Una Account por usuario bajo su propia Entidad

  • Estructura: muchas Entidades (una por cliente), cada una con su propia Account y Account Number raíz.
  • Saldo por usuario: Fintoc lo lleva a nivel de Account.
  • KYB: requerido por Entidad (~1 día hábil por cliente).
Configuración:
  1. Crea una Entidad en el Dashboard para el cliente.
  2. Fintoc ejecuta el KYB; te notificamos cuando esté aprobado.
  3. Una vez aprobada, crea una Account bajo esa Entidad. Las transferencias salientes desde esa Account muestran la razón social del cliente en el CEP.
Bueno para: flujos donde los comprobantes deben mostrar el nombre del cliente (por ejemplo, una plataforma de delivery de comida que paga a cada restaurante bajo el RFC/RUT de ese restaurante).

​
Cómo elegir entre ellos