Saltar al contenido principal

​
Qué vas a construir

Envía dinero desde tu Account de Fintoc a la cuenta bancaria de un tercero y rastrea cada cambio de estado mediante webhooks. En México, los payouts usan el riel del Sistema de Pagos Electrónicos Interbancarios (SPEI). En Chile, los payouts usan el riel de Transferencia Electrónica de Fondos (TEF). El tiempo de liquidación depende del riel.

​
Cuándo usarlo

  • Desembolsos y reembolsos de préstamos.
  • Payouts de marketplaces a vendedores.
  • Retiros de wallets.
  • Pagos a proveedores.

​
Cómo funciona

​
Checklist de implementación

Completa estos pasos para enviar un payout:
  1. Fondea la cuenta de origen. Envía dinero desde la cuenta bancaria externa de tu empresa al root_account_number de tu cuenta Fintoc.
  2. Crea la transferencia. Formato completo del request, ejemplos para MX y CL, campos de counterparty: Enviar transferencias → Crear una transferencia.
  3. Maneja los webhooks. Catálogo de eventos y semántica de estados: Enviar transferencias → Monitorear el estado.
  4. Verifica primero el destino (opcional). Si tu cliente ingresó el número de cuenta bancaria estandarizado de México (CLABE), consulta Verifica una CLABE antes del payout.

​
Un error común

Los webhooks pueden llegar en desorden. Siempre ramifica tu lógica en data.status, no en qué evento llegó primero. Consulta Enviar transferencias → Monitorear el estado para más detalles.