Payouts a usuarios o proveedores

​

Qué vas a construir

​

Cuándo usarlo

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

​

Cómo funciona

1. Tu backend hace POST a /v2/transfers.
2. Fintoc envía la transferencia a SPEI (MX) o TEF (CL).
3. Se dispara un webhook: transfer.outbound.succeeded / .rejected / .failed.
4. Tu backend actualiza al usuario o la orden.

​

Checklist de implementación

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. (Opcional) Verifica primero el destino si el Account Number fue ingresado por un usuario. Consulta Verifica una CLABE antes del payout.

​

Un error común