Magento

Esta guía te llevará a través del proceso de integración de Fintoc en tu tienda Magento. Siguiendo estos pasos, podrás ofrecer una experiencia de pago fluida a tus clientes y aumentar tus ventas.

​

Requisitos previos

Antes de empezar, necesitas:

• Una cuenta de Fintoc con credenciales de API (Secret Key y Webhook Secret).
• Acceso de administrador a tu tienda Magento 2.
• Acceso de desarrollador (si necesitas instalar o actualizar el módulo).

Puedes encontrar tus credenciales de API en el Dashboard de Fintoc.

​

Primeros pasos: credenciales y configuración

​

1. Regístrate

Para iniciar el proceso, dirígete al Dashboard de Fintoc y regístrate. Para comenzar a recibir pagos en modo Live, completa tu información para facilitar la activación de la cuenta y proporcionarte las credenciales necesarias.

​

2. Obtén las API Keys

Dentro de tu Dashboard de Fintoc encontrarás API Keys tanto de Test como de Live. Debes usar tus API Keys de Live para configurar Fintoc en Magento. Para obtener tus API Keys de Live, asegúrate de estar en modo Live revisando el botón en la parte superior izquierda de nuestro dashboard. Luego, dirígete a For Developers → API Keys para obtenerlas.

​

Proceso de integración y configuración

​

Instalación (si no está preinstalada)

Asegúrate de que el módulo esté instalado y habilitado por tu desarrollador o partner.

• Ejemplo (para desarrolladores):
  • composer require fintoc/module-payment
  • bin/magento module:enable Fintoc_Payment
  • bin/magento setup:upgrade
  • bin/magento cache:flush

​

Habilitar el plugin en tu tienda Magento

1. Inicia sesión en tu panel de administración de Magento.
2. Ve a Stores → Configuration → Sales → Payment Methods → Fintoc.
   
   
3. En Basic Settings, ingresa:
   • Secret API Key (desde el Dashboard de Fintoc)
   • Webhook Secret (desde el Dashboard de Fintoc, esto se explica en la siguiente sección).
   • (Opcional) Ajusta la configuración de logging y debug: Enable Logging, Debug Mode, define el Debug Level y activa o desactiva Log Sensitive Data.
4. En Payment Initiation, configura:
   • Enabled: Yes
   • Title: nombre visible (por ejemplo, Paga con Fintoc)
   • Automatically Invoice All Items (opcional)
   • New Order Status: usualmente Pending o Processing dependiendo de tu política de facturación
   • Applicable Countries: todos o seleccionados
   • Maximum Order Amount (opcional)
   • Sort Order (orden de visualización en el checkout)
5. En Refunds (opcional):
   • Habilita Refunds y Partial Refunds
   • Habilita Auto-create Credit Memo
   • Define las transiciones de estado para los eventos de Refund (Pending, Succeeded, Failed, Canceled)
6. Haz clic en Save Config y, si se te solicita, limpia las cachés.

​

Administración de Magento

Para transacciones

1. Ve a Sales → Fintoc → Transactions en el panel de administración de Magento.
   
2. Usa los filtros para buscar por ID de orden o de transacción.
   
3. Haz clic en cualquier transacción para ver los detalles y los logs de webhooks.
   

Puedes emitir reembolsos directamente desde Magento:

1. Ve a Sales → Fintoc → Refundable Orders, abre el formulario de reembolso y envíalo.
   
2. O usa el flujo estándar de Credit Memo si está configurado.

Magento enviará automáticamente las solicitudes de reembolso a Fintoc y actualizará los estados en consecuencia.

​

Configuración de webhooks

Para mantener sincronizados los estados de los pagos:

1. En tu Dashboard de Fintoc, crea un nuevo webhook.
   • Configura la URL como {STORE_URL}/fintoc/webhook
   • Método POST
2. Copia el Webhook Secret y pégalo en la configuración de Fintoc en Magento (Stores → Configuration → Sales → Payment Methods → Fintoc → Basic Settings → Webhook Secret).
3. Prueba el envío desde Fintoc y verifica que Magento responda con 200 OK.
   

​

Buenas prácticas

• Mantén el logging habilitado en producción con un Debug Level razonable. Evita registrar datos sensibles a menos que el soporte lo solicite.
• Verifica que tu servidor sea accesible públicamente para Fintoc para los webhooks (firewalls, modo de mantenimiento, listas de IP permitidas).
• Si los clientes reportan que no aparece el método de pago, revisa las restricciones de país y la configuración de monto máximo de la orden.

​

Solución de problemas

Aquí hay algunos problemas que podrías encontrar y cómo resolverlos.

​

Soporte

• Proporciona las entradas recientes de var/log/fintoc*.log al contactar al soporte.
• Comparte el increment ID de la orden y (si está disponible) el transaction_id de Fintoc para un diagnóstico más rápido.

​

Pruebas

1. En la app de Fintoc, cambia a modo Test usando la casilla para probar pagos sin afectar las órdenes reales.
2. Realiza órdenes de prueba para asegurarte de que los pagos se procesen correctamente. Para más información sobre pruebas, consulta nuestras pautas de testing.

​

Pasar a producción

1. Una vez que estés satisfecho con las pruebas, cambia la app a modo Live o Producción desmarcando la casilla.
2. Realiza algunas órdenes más en el ambiente live para asegurarte de que todo funcione como se espera.

¡Felicidades! Tu tienda Magento ya está completamente equipada para aceptar pagos a través de Fintoc, mejorando la experiencia de compra de tus clientes e impulsando tus ventas.

​

Preguntas frecuentes

P: ¿Cómo manejo los reembolsos y disputas? R: Los reembolsos se pueden gestionar directamente desde tu dashboard de Magento. Ve a una orden, donde encontrarás un botón de Refund en la esquina superior derecha. Allí puedes ingresar el monto del reembolso y cualquier comentario que quieras registrar. Para más detalles sobre cómo funcionan los reembolsos en Fintoc, consulta nuestra guía de reembolsos.