Skip to main content
Configura Fintoc en tu tienda WooCommerce para aceptar pagos con transferencia bancaria cuenta a cuenta y tarjeta en pesos chilenos (CLP) y pesos mexicanos (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). Para obtenerla, contacta a tu representante de ventas o escribe a sales@fintoc.com. Fintoc activa tu cuenta y te da acceso al dashboard de Fintoc.
  • Acceso de administrador a tu sitio de WordPress.
  • WordPress 6.2+, WooCommerce 7.4+ y PHP 7.4+.

​
Obtén tus credenciales de API

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 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, 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.*. El plugin usa estos eventos para confirmar pagos y conciliar 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.

​
Estados de los pedidos

Una transferencia bancaria no siempre se confirma en segundos. Según el banco, la transferencia puede tardar minutos, horas o días. El plugin refleja esa espera en el estado del pedido. Cuenta con ver On hold cada vez que tu cliente vuelve a tu tienda antes de que Fintoc confirme el pago:

​
Pedidos en On hold

Mientras un pedido está en On hold, el plugin lo protege:
  • WooCommerce no cancela los pedidos en On hold. WooCommerce cancela los pedidos en Pending payment cuando llevan impagos más tiempo que el ajuste Hold stock (minutes), 60 minutos por defecto. Ese ajuste está en WooCommerce → Settings → Products → Inventory.
  • El pedido reserva su stock, así que los productos no se agotan por otra compra mientras Fintoc valida el pago.
  • El cliente no puede iniciar un segundo pago para el mismo pedido, así que no puede pagar dos veces.
No canceles estos pedidos a mano. El plugin resuelve cada uno cuando Fintoc confirma el resultado: Processing si el pago es exitoso, Failed si no lo es. Cuando falla, el plugin restituye el stock que el pedido había reservado. Los webhooks son la señal principal. Como respaldo, el plugin también consulta el pago en la API de Fintoc de forma programada. El primer reintento ocurre 15 minutos después de que el pedido pasa a On hold. Los siguientes se espacian hasta una vez al día. El plugin se detiene tras 10 reintentos, unos cuatro días después de que el pedido pasa a On hold. Si el pago sigue sin resolverse, el plugin deja una nota en el pedido y espera el webhook. Fintoc expira los pagos que nunca se confirman, así que el pedido no queda en On hold para siempre.
Tu cliente recibe el correo estándar de WooCommerce Order on-hold cuando Fintoc empieza a validar el pago. Para desactivar el correo, ve a WooCommerce → Settings → Emails → Order on-hold.

​
Pagos duplicados

Si un segundo pago tiene éxito sobre un pedido ya pagado, el plugin deja una nota en el pedido, registra un error y envía un correo al administrador de la tienda. El dinero se movió dos veces, así que reembolsa el pago duplicado desde el dashboard de Fintoc.

​
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.
Puedes emitir reembolsos directamente desde WooCommerce, pero no puedes cancelar esos reembolsos ahí. Para cancelar un reembolso emitido desde WooCommerce, usa el endpoint Cancelar reembolsos o contacta a soporte. WooCommerce no muestra la cancelación.

​
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.
  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 secret key de live.
  2. Realiza un pedido en modo live 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:

​
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). P: ¿Por qué un pedido queda en On hold? R: Fintoc está validando el pago. Una transferencia bancaria puede tardar horas o días en confirmarse. El plugin mueve el pedido a Processing o a Failed cuando Fintoc confirma el resultado. No canceles el pedido a mano. El pedido reserva su stock y el cliente no puede volver a pagar mientras el pedido espera. P: ¿Por qué un cliente recibe un correo de pedido en espera? R: WooCommerce envía ese correo cada vez que un pedido pasa a On hold, lo que ahora ocurre mientras Fintoc valida el pago. Para desactivarlo, ve a WooCommerce → Settings → Emails → Order on-hold.