Saltar al contenido principal
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.
  • 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 y regístrate. Para empezar a recibir pagos en modo live, completa tu información 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 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.* 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.
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 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 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:

​
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).