> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Magento

> Acepta pagos usando la app de Fintoc en tu tienda 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](https://dashboard.fintoc.com/login).

# Primeros pasos: credenciales y configuración

### 1. Regístrate

Para iniciar el proceso, dirígete al [Dashboard de Fintoc y regístrate](/es/docs/home/dashboard/guides-api-keys). Para comenzar a recibir pagos en modo Live, [completa tu información](https://tally.so/r/mKLrWz) 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**.

   <Frame>
     <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/1a9965bf2ba52f01db19075a258fcc715f1c3776a1afd11110cedc03cc12ca1f-Screenshot_2025-10-09_at_12.16.15_PM.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=986ab9b0edfaf101803b30d399b9838d" width="2322" height="1508" data-path="images/1a9965bf2ba52f01db19075a258fcc715f1c3776a1afd11110cedc03cc12ca1f-Screenshot_2025-10-09_at_12.16.15_PM.png" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/6430fb125c0882cc612bee023655a116be06c1512797285b569ad34905ad5333-Screenshot_2025-10-09_at_12.16.50_PM.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=f91cab0ba3218f678170cdd3ba0cadd2" width="2322" height="1146" data-path="images/6430fb125c0882cc612bee023655a116be06c1512797285b569ad34905ad5333-Screenshot_2025-10-09_at_12.16.50_PM.png" />
   </Frame>
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.

<br />

## Administración de Magento

**Para transacciones**

1. Ve a Sales → Fintoc → Transactions en el panel de administración de Magento.

   <Frame>
     <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/3ea0f0e493b9121a01d826f7b76296f0560c35ab62dece5f30882ba3ee684c01-Screenshot_2025-10-10_at_4.04.57_PM.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=7a7add130cd7d9a4a681a1dbeb2bdec7" width="2236" height="814" data-path="images/3ea0f0e493b9121a01d826f7b76296f0560c35ab62dece5f30882ba3ee684c01-Screenshot_2025-10-10_at_4.04.57_PM.png" />
   </Frame>
2. Usa los filtros para buscar por ID de orden o de transacción.

   <Frame>
     <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/25d47b38b23503108f0880b1daa1c13f83b317d450036414f5dac0defdc357fe-Screenshot_2025-10-10_at_4.06.58_PM.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=1e1389c369ad9726702c45af195a592b" width="2790" height="1038" data-path="images/25d47b38b23503108f0880b1daa1c13f83b317d450036414f5dac0defdc357fe-Screenshot_2025-10-10_at_4.06.58_PM.png" />
   </Frame>
3. Haz clic en cualquier transacción para ver los detalles y los logs de webhooks.

   <Frame>
     <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/78c98a92e1ce4513a05e4c56fff9e9604f92fca3ad41798a64ded45edd678941-Screenshot_2025-10-10_at_4.07.49_PM.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=5aede1bb7b4df2c1f26b2e72a5edd87c" width="2790" height="992" data-path="images/78c98a92e1ce4513a05e4c56fff9e9604f92fca3ad41798a64ded45edd678941-Screenshot_2025-10-10_at_4.07.49_PM.png" />
   </Frame>

**Puedes emitir reembolsos directamente desde Magento:**

1. Ve a Sales → Fintoc → Refundable Orders, abre el formulario de reembolso y envíalo.

   <Frame>
     <img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/8ddecae4211b22fb41b117c15a65aad0a572cd855b591e6bd0bb0d35d0746cf3-Screenshot_2025-10-10_at_4.12.00_PM.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=98158f3942bc6dcda42302308748b8fd" width="2836" height="1010" data-path="images/8ddecae4211b22fb41b117c15a65aad0a572cd855b591e6bd0bb0d35d0746cf3-Screenshot_2025-10-10_at_4.12.00_PM.png" />
   </Frame>
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.

   <Frame>
     <img src="https://mintcdn.com/fintoc-49b8bee8/SkvJJ-DZ5D4yC6tQ/images/d7f2612e2fd38027bf8901de365f37c8473a6803f3ef63f9a81b13e436c14d3b-Screenshot_2025-10-10_at_3.36.08_PM.png?fit=max&auto=format&n=SkvJJ-DZ5D4yC6tQ&q=85&s=93906dee8e1022845fd50ac463d05c9c" width="2734" height="1182" data-path="images/d7f2612e2fd38027bf8901de365f37c8473a6803f3ef63f9a81b13e436c14d3b-Screenshot_2025-10-10_at_3.36.08_PM.png" />
   </Frame>

<br />

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

| Problema                   | Causa                                         | Solución                                                     |
| :------------------------- | :-------------------------------------------- | :----------------------------------------------------------- |
| Errores 401/400 en webhook | Webhook Secret inválido                       | Verifica el secret tanto en Fintoc como en Magento           |
| Errores 5xx en webhook     | Servidor inalcanzable o error interno         | Revisa los logs en var/log/fintoc.log                        |
| El pago no aparece         | Deshabilitado, restringido o supera el límite | Verifica la configuración en Payment Methods                 |
| Reembolso no procesado     | Problema en la entrega del webhook            | Revisa la configuración de reembolsos y los logs del webhook |

### 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](/es/docs/payments/payment-initiation-test-your-integration).

## 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](/es/docs/payments/fintoc-collect-payments/payment-initiation-refunds).

<Warning>
  **Reembolsos para plugins de e-commerce**

  Puedes **emitir** reembolsos directamente desde tu plataforma de e-commerce (Magento, VTEX, Shopify), pero debido al funcionamiento de los plugins, **los reembolsos solicitados desde plataformas de plugins de e-commerce no pueden cancelarse desde sus dashboards**.

  Si emitiste un reembolso desde una de estas plataformas y quieres cancelarlo, puedes usar nuestro endpoint de API [Cancelar reembolsos](/es/reference/payments-api/refunds/refunds-cancel) o contactar a nuestro equipo de soporte, pero ten en cuenta que **la cancelación no se verá reflejada en tu Dashboard de Magento, VTEX o Shopify**.
</Warning>