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-payment
bin/magento module:enable Fintoc_Payment
bin/magento setup:upgrade
bin/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:

  1. En el Dashboard de Fintoc, crea un nuevo webhook con URL {URL_DE_TU_TIENDA}/fintoc/webhook y método POST.

  2. Copia el Webhook Secret que genera Fintoc.

  3. Pégalo en Magento: Stores → Configuration → Sales → Payment Methods → Fintoc → Basic Settings → Webhook Secret.

  4. Prueba la entrega desde Fintoc y verifica que responda 200 OK.

VI. Prueba y sal a producción

  1. Cambia a modo Test en el Dashboard y haz órdenes de prueba.

  2. 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

Preguntas relacionadas

¿No encontraste lo que buscabas?

Escríbenos desde tu cuenta de Fintoc.

Hablar con soporte en el dashboard
Tema

Conversa con un experto en medios de pago