Cómo integrar Fintoc en Magento
Con el módulo de Fintoc tu tienda Magento 2 puede aceptar pagos por transferencia bancaria. La instalación requiere acceso de desarrollador (se instala vía composer), pero la configuración es directa.
I. Antes de partir
Una cuenta de Fintoc activada en modo Live (créala en el Dashboard y completa los datos de tu empresa).
Acceso de administrador a Magento 2 y acceso de desarrollador para instalar el módulo.
II. Obtén tus credenciales
En el Dashboard, cambia a modo Live y ve a Para Desarrolladores → API Keys. Vas a necesitar tu Secret API Key (y más adelante, el Webhook Secret del paso V).
III. Instala el módulo
Tu desarrollador debe ejecutar:
composer require fintoc/module-paymentbin/magento module:enable Fintoc_Paymentbin/magento setup:upgradebin/magento cache:flush
IV. Configura el módulo
En el admin de Magento, ve a Stores → Configuration → Sales → Payment Methods → Fintoc:
Basic Settings: pega tu Secret API Key y el Webhook Secret (paso V).
Payment Initiation: Enabled → Yes · Title → el nombre que verá tu cliente (ej. "Paga con Fintoc") · estado de las órdenes nuevas · países aplicables · monto máximo (opcional) · posición en el checkout.
Refunds (opcional): habilita Refunds y Partial Refunds, y el Auto-create Credit Memo si quieres que las notas de crédito se generen solas.
Guarda con Save Config y limpia el caché cuando Magento lo pida.
V. Configura el webhook (obligatorio)
Así Fintoc confirma los pagos en tu tienda:
En el Dashboard de Fintoc, crea un nuevo webhook con URL
{URL_DE_TU_TIENDA}/fintoc/webhooky método POST.Copia el Webhook Secret que genera Fintoc.
Pégalo en Magento: Stores → Configuration → Sales → Payment Methods → Fintoc → Basic Settings → Webhook Secret.
Prueba la entrega desde Fintoc y verifica que responda 200 OK.
VI. Prueba y sal a producción
Cambia a modo Test en el Dashboard y haz órdenes de prueba.
Cuando todo funcione, vuelve a modo Live y haz una orden final de verificación.
Para operar el día a día
Transacciones: en Sales → Fintoc → Transactions puedes filtrar por orden o ID, y ver el detalle y los logs de webhook de cada pago.
Reembolsos: desde Sales → Fintoc → Refundable Orders o con el flujo estándar de Credit Memo — el detalle está en ¿Cómo manejo los reembolsos y disputas?
Si algo no funciona
Webhook con error 401/400: el Webhook Secret no coincide — revísalo en ambos lados.
Fintoc no aparece en el checkout: revisa que esté habilitado, que el país esté permitido y que la orden no supere el monto máximo configurado.
Reembolso sin procesar: revisa los logs de webhook en
var/log/fintoc.log.
Ahora tus clientes pueden pagar con una experiencia mucho menos friccionada y tú recibes tus pagos en menos tiempo y con menos costo de comisiones