Payins en Account Numbers dedicados

​

Qué vas a construir

​

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

1. Tu backend crea un Account Number con metadata.customer_id.
2. Fintoc devuelve un Account Number.
3. Tu cliente envía una Transferencia a ese Account Number.
4. Fintoc dispara transfer.inbound.succeeded con tu metadata adjunta.
5. Tu backend marca la factura como pagada.

​

¿Un Account Number por cliente o uno por orden?

​

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 y options.max_amount para rechazar automáticamente montos incorrectos, y deshabilita el Account Number 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. Los Account Numbers obsoletos siguen aceptando transferencias, lo que puede contaminar tu conciliación y tus estados de cuenta.