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

# WooCommerce

> Acepta pagos con transferencia bancaria y tarjeta usando el plugin de Fintoc en tu tienda WooCommerce.

Configura Fintoc en tu tienda WooCommerce para aceptar pagos con **transferencia bancaria** cuenta a cuenta y **tarjeta** en **Chile (CLP)** y **México (MXN)** a través del Checkout Session alojado de Fintoc.

El cliente realiza un pedido y Fintoc lo redirige para autorizar el pago. Después de que el cliente vuelve a tu tienda, el plugin confirma el pedido en segundo plano mediante webhooks y verifica cada evento contra la API de Fintoc. La API es la fuente de verdad del estado del pago.

## Requisitos previos

Antes de empezar, necesitas:

* Una cuenta de Fintoc con credenciales de API (secret key). Puedes encontrar tus claves en el [Dashboard de Fintoc](https://dashboard.fintoc.com/login).
* Acceso de administrador a tu sitio de WordPress.
* WordPress 6.2+, WooCommerce 7.4+ y PHP 7.4+.

## Obtén tus credenciales de API

### 1. Regístrate

Dirígete al [Dashboard de Fintoc](https://dashboard.fintoc.com/login) y regístrate. Para empezar a recibir pagos en modo `live`, [completa tu información](https://tally.so/r/mKLrWz) para que Fintoc pueda activar tu cuenta y entregarte las credenciales que necesitas.

### 2. Obtén las API keys

Tu dashboard de Fintoc muestra las secret keys de `test` y de `live`. Para obtenerlas, ve a **For Developers → API Keys**. Usa el botón en la parte superior izquierda del dashboard para alternar entre los modos `test` y `live`. **Usa tu secret key de `live` (`sk_live_...`) para configurar Fintoc en producción.**

## Instala el plugin

Descarga el paquete más reciente del plugin desde la [página de Fintoc para WooCommerce](https://woocommerce.fintoc.com/) y luego instálalo:

1. Sube la carpeta `fintoc-for-woocommerce` a `/wp-content/plugins/`, o instala el ZIP desde **Plugins → Add New → Upload Plugin**.
2. Activa el plugin desde el menú **Plugins** en WordPress.

El plugin es compatible con High-Performance Order Storage (HPOS) y funciona tanto con el checkout clásico (shortcode) como con el nuevo checkout de Blocks (Store API).

## Configura el plugin

1. Ve a **WooCommerce → Settings → Payments → Fintoc**.
2. En la pantalla de configuración, define:
   * **Enable Fintoc**: el interruptor que activa la pasarela.
   * **Title**: el nombre del método de pago que se muestra a los clientes en el checkout (por ejemplo, `Fintoc`).
   * **Description**: el texto que se muestra bajo el método de pago en el checkout.
   * **Test mode**: el interruptor que usa tus claves de test; déjalo desactivado para recibir pagos reales.
   * **Live secret key**: tu clave `sk_live_...` del dashboard.
   * **Test secret key**: tu clave `sk_test_...`, necesaria solo mientras el modo test está activado.
   * **Debug log**: el interruptor que registra las solicitudes a la API y los eventos de webhook en **WooCommerce → Status → Logs** (fuente `fintoc`).
3. Guarda los cambios.

La pasarela se oculta automáticamente cuando la moneda de la tienda es distinta de CLP o MXN. El panel **Payment methods** en la pantalla de configuración muestra qué métodos (transferencias bancarias, tarjetas) tiene habilitados tu organización de Fintoc. Fintoc gestiona la habilitación de métodos por organización; no es autoservicio.

### Configuración del webhook

Los webhooks son la forma en que Fintoc confirma los pagos, así que este paso es obligatorio.

1. En la pantalla de configuración de Fintoc en WooCommerce, copia la URL del **Webhook endpoint** que se muestra ahí.
2. En tu [Dashboard de Fintoc](https://dashboard.fintoc.com/login), crea un nuevo webhook endpoint con esa URL y el método `POST`.
3. Suscribe el endpoint a los eventos `payment_intent.*`, `checkout_session.*` y `refund.*` para que el plugin pueda confirmar o revertir los resultados de los reembolsos.

No se necesita un webhook secret. El plugin verifica cada evento consultando el estado del pago directamente en la API de Fintoc antes de actualizar un pedido, por lo que el payload del webhook solo se usa para localizar el pedido.

## Gestiona los reembolsos

Puedes emitir reembolsos totales y parciales directamente desde la pantalla del pedido en WooCommerce. Abre el pedido, haz clic en **Refund**, ingresa el monto y envíalo. El plugin envía la solicitud a la API de Reembolsos de Fintoc y concilia el resultado a través de los eventos de webhook `refund.*`.

Los tiempos de confirmación de los reembolsos varían según el país. Para las transferencias bancarias, Fintoc puede reintentar durante hasta 7 días cuando no hay saldo suficiente, por lo que un reembolso puede permanecer pendiente hasta que se confirme.

<Warning>
  Puedes **emitir** reembolsos directamente desde WooCommerce, pero los dashboards de los plugins **no pueden cancelar esos reembolsos**. Para cancelar un reembolso emitido desde WooCommerce, usa el endpoint [Cancelar reembolsos](/es/reference/payments-api/refunds/refunds-cancel) o contacta a soporte. WooCommerce no muestra la cancelación.
</Warning>

## Prueba la integración

1. Activa **Test mode** en la pantalla de configuración y pega tu test secret key (`sk_test_...`).
2. Realiza un pedido de prueba con cada método de pago habilitado y completa la autorización en el sandbox de Fintoc. Un pago exitoso mueve el pedido a **Processing** y registra los eventos de webhook `payment_intent.*` y `checkout_session.*` correspondientes. Para credenciales de prueba y detalles del sandbox, consulta [Prueba tu integración](/es/docs/payments/payment-initiation-test-your-integration).
3. Activa **Debug log** y revisa **WooCommerce → Status → Logs** (fuente `fintoc`) para inspeccionar las solicitudes a la API y los eventos de webhook.

## Pasa a producción

1. Cuando estés conforme con las pruebas, desactiva **Test mode** para que la pasarela use tu live secret key.
2. Realiza un pedido real con cada método de pago habilitado para confirmar el flujo completo de extremo a extremo.

Tu tienda WooCommerce ya acepta pagos a través de Fintoc.

## Solución de problemas

Problemas comunes y sus soluciones:

| Problema                                          | Causa                                                                   | Solución                                                                      |
| :------------------------------------------------ | :---------------------------------------------------------------------- | :---------------------------------------------------------------------------- |
| Fintoc no aparece en el checkout                  | La moneda de la tienda no es CLP ni MXN, o la pasarela está desactivada | Verifica la moneda de la tienda y que la pasarela esté activada               |
| Los pedidos no se confirman                       | El webhook endpoint no está registrado o es inaccesible                 | Registra el endpoint y suscríbelo a `payment_intent.*` y `checkout_session.*` |
| Los reembolsos nunca se confirman ni se revierten | Los eventos `refund.*` no están suscritos                               | Suscribe el webhook endpoint a `refund.*`                                     |
| Error de reembolso entre modos                    | El pedido se pagó en test y la pasarela está en live (o viceversa)      | Haz coincidir el modo de la pasarela con el modo en que se pagó el pedido     |

## Preguntas frecuentes

**P: ¿Qué monedas se admiten?**

R: Pesos chilenos (CLP) y pesos mexicanos (MXN). La pasarela se oculta automáticamente cuando la moneda de la tienda es cualquier otra.

**P: ¿Necesito un webhook secret?**

R: No. El plugin verifica cada evento consultando el estado del pago directamente en la API de Fintoc antes de actualizar un pedido. No configuras un webhook secret ni en el plugin ni en el dashboard.

**P: ¿Se admite el checkout de Blocks?**

R: Sí. Se admiten tanto el checkout clásico (shortcode) como el checkout de Blocks (Store API).