Prerrequisitos
Fintoc soporta dos modelos de integración:- Fintoc Collects: Fintoc retiene las credenciales y liquida en una cuenta agrupada. Sin convenio de tu lado.
- Directo: Tú tienes el convenio y liquidas en tu propia cuenta. Contacta al equipo de Fintoc para registrar tus credenciales.
Orquestación
El motor de orquestación de Fintoc selecciona el método de pago en tiempo de ejecución según la institución del cliente y el monto. Cuando un cliente selecciona transferencia bancaria, el motor primero intenta una transferencia bancaria estándar a través de esa institución. Si el monto excede el límite de transacción de la institución, el motor enruta al cliente al método de pago alternativo de la institución. El cliente completa el pago en el checkout propio de la institución. Este fallback se ejecuta automáticamente una vez que registras tus credenciales. Cada método soportado aparece como un botón en tu checkout, y Fintoc enruta al cliente al método correcto según el monto y la institución. Consulta Límites de transacción para los topes por institución que disparan el redireccionamiento.Métodos y límites disponibles
Fintoc soporta las siguientes instituciones chilenas:
Los bancos limitan la primera transferencia de un cliente a un destinatario nuevo a un monto más bajo que las transferencias subsecuentes. El motor de orquestación considera esto al elegir el método de pago. La tabla a continuación muestra algunos ejemplos de resultados:
Reembolsos para métodos de pago alternativos
El cliente autoriza estos pagos a través del checkout propio de la institución, por lo que Fintoc nunca recibe los detalles de su cuenta bancaria. Para reembolsar un pago hecho a través de uno de estos métodos, recolectas la cuenta de destino del cliente. Envía el reembolso desde el Dashboard, o pasarecipient_account cuando crees el reembolso vía API.
Los reembolsos están disponibles para Banco Estado, Banco de Chile y Banco Santander.
El objeto recipient_account lleva los datos bancarios del cliente: holder_id, holder_name, number, type e institution_id. holder_id debe ser un tax ID chileno válido; type debe ser checking_account o sight_account. Consulta Create a Refund para la forma completa y la guía Refund payments para el flujo end-to-end.
Políticas de seguridad
Los reembolsos con unrecipient_account personalizado están sujetos a las políticas de seguridad de Fintoc, que pueden bloquear un reembolso antes del desembolso. Si un reembolso es bloqueado, recibes un webhook refund.failed con failure_code en fraud_risk. No se transfieren fondos y no se notifica al cliente. Los reembolsos bloqueados no consumen el saldo reembolsable del pago, por lo que puedes emitir otro reembolso sobre el mismo pago.