Cómo integrar Webpay en WooCommerce: guía paso a paso para Chile

Webpay Plus es la pasarela de pago más usada en Chile. Más del 70% de las transacciones online en el país pasan por ella. Si tienes una tienda WooCommerce y no tienes Webpay configurado, estás dejando ir una parte importante de tus ventas potenciales.

La integración es más simple de lo que parece. Transbank ofrece un plugin oficial para WooCommerce, gratuito y con soporte activo.

Esta guía cubre todo el proceso: desde instalar el plugin hasta activar el ambiente de producción y hacer la primera venta real.

Qué necesitas antes de empezar

Antes de instalar el plugin, verifica que tengas:

• un sitio WordPress con WooCommerce instalado y activo;
• una cuenta de comercio en Transbank (puedes solicitarla en transbank.cl/comercios);
• credenciales de producción: Commerce Code y API Key (Transbank las entrega por correo al aprobar tu solicitud);
• SSL activo en tu sitio (https:// obligatorio para procesar pagos reales);
• hosting con PHP 7.4 o superior (todos los planes de Elevocloud lo incluyen).

Si aún no tienes cuenta en Transbank, el proceso de registro demora entre 3 y 5 días hábiles. Puedes avanzar con la instalación y las pruebas mientras esperas las credenciales de producción.

Paso 1: Instalar el plugin oficial de Transbank

Transbank mantiene un plugin oficial en el repositorio de WordPress.

Desde tu panel de WordPress:

1. Ve a Plugins → Añadir nuevo;
2. busca "Transbank Webpay Plus WooCommerce";
3. instala el plugin de Transbank S.A. (verifica que el autor sea Transbank, no un tercero);
4. actívalo.

También puedes descargarlo directamente desde el repositorio oficial de Transbank en GitHub si prefieres instalarlo manualmente.

Paso 2: Configurar el ambiente de integración (pruebas)

Antes de usar credenciales reales, trabaja en el ambiente de integración. Transbank provee datos de prueba para validar que todo funcione.

Desde WordPress:

1. Ve a WooCommerce → Ajustes → Pagos;
2. activa "Webpay Plus" y haz clic en "Gestionar";
3. en "Ambiente", selecciona Integración;
4. el plugin completa automáticamente las credenciales de prueba (Commerce Code: 597055555532 y una API Key de test).

Con esto activado, puedes hacer compras de prueba usando las tarjetas de test de Transbank.

Credenciales de prueba más comunes:

Haz al menos 3 compras de prueba: una aprobada, una rechazada y una cancelada. Verifica que WooCommerce actualice correctamente el estado del pedido en cada caso.

Paso 3: Activar el ambiente de producción

Cuando hayas recibido tus credenciales reales de Transbank y validado las pruebas, es momento de pasar a producción.

En la configuración del plugin:

1. Cambia "Ambiente" a Producción;
2. ingresa tu Commerce Code real (el número de comercio que te dio Transbank);
3. ingresa tu API Key de producción;
4. guarda los cambios.

Haz una compra real de bajo monto (por ejemplo $1.000 CLP) para confirmar que el flujo completo funciona: pago, aprobación y actualización del estado del pedido en WooCommerce.

Errores comunes y cómo solucionarlos

El pago se procesa pero el pedido queda en "Pendiente": Revisa que tu SSL esté activo. Transbank no puede comunicarse con tu sitio por HTTP. Si tienes Cloudflare, verifica que no esté en modo proxy que interfiera con las notificaciones.

Error "Comercio no encontrado" en producción: El Commerce Code ingresado no coincide con el registrado en Transbank. Verifica que copiaste el número correctamente y que el contrato con Transbank esté activo.

El cliente llega a Webpay pero no vuelve al sitio: La URL de retorno puede estar bloqueada por un firewall o configuración de seguridad. En Elevocloud esto no ocurre por defecto, pero si tienes un plugin de seguridad activo, verifica que no bloquee las IPs de Transbank.

Webpay no aparece como opción de pago: Verifica que WooCommerce esté configurado con CLP (peso chileno) como moneda. Webpay solo opera en pesos chilenos.

Configuración recomendada para tiendas chilenas

Después de activar Webpay, considera también:

• Khipu (para transferencias bancarias inmediatas, ideal para montos altos);
• Flow (alternativa completa que incluye Webpay, transferencias y tarjetas internacionales);
• Mercado Pago (si también vendes a clientes de otros países de Latinoamérica).

Ofrecer más de una opción de pago reduce el abandono de carrito. Webpay cubre tarjetas de débito y crédito chilenas; las transferencias y billeteras digitales cubren el resto.

El hosting que uses debe tener PHP actualizado y SSL incluido para que Webpay funcione sin problemas. Ver planes de hosting WooCommerce en Elevocloud

Preguntas frecuentes

¿Cuánto cobra Transbank por cada transacción? Las tarifas varían según el tipo de comercio y el volumen mensual. Transbank cobra un porcentaje sobre cada venta aprobada, más una comisión fija en algunos planes. Los detalles están en transbank.cl/comercios.

¿Puedo usar Webpay en un sitio de prueba local (localhost)? El ambiente de integración funciona con localhost para desarrollo, pero el ambiente de producción requiere un dominio real con SSL. No se pueden procesar pagos reales desde localhost.

¿El plugin de Transbank es gratuito? Sí. El plugin oficial es gratuito. Lo que cobra Transbank son las comisiones por transacción, no el software de integración.

¿Webpay funciona con cuotas? Sí. Los titulares de tarjeta pueden seleccionar cuotas directamente en el formulario de Webpay. Tú recibes el monto completo; el costo de las cuotas lo asume el banco del cliente o Transbank según el caso.

¿Qué pasa si un cliente paga y después pide devolución? Las devoluciones (reversa o anulación) se gestionan desde el panel de Transbank o mediante la API. El plugin oficial incluye la opción de reembolso desde el panel de WooCommerce para pedidos recientes.

¿Tu hosting tiene todo lo que necesita WooCommerce? Revisa nuestros planes con PHP actualizado y SSL incluido