Respuesta corta: instala el plugin oficial Transbank Webpay desde Plugins › Añadir nuevo plugin. En WooCommerce › Ajustes › Pagos, activa Transbank Webpay Plus y pruébalo en el ambiente de Integración con las tarjetas de prueba de Transbank. Cuando tengas tu contrato, cambia a Producción e ingresa tu código de comercio y tu llave secreta.
Webpay es el medio de pago más conocido en Chile: permite pagar con tarjetas de crédito, débito y prepago. Si tienes una tienda en WooCommerce, agregarlo es simple, porque Transbank mantiene un plugin oficial y gratuito.
Lo que necesitas
- Una tienda WooCommerce funcionando, con los precios en pesos chilenos. Si aún no la tienes, revisa cómo instalar WooCommerce.
- Certificado SSL activo: tu tienda debe abrir con
https://. - Un hosting confiable: el pago va y vuelve entre tu tienda y Transbank, así que tu sitio tiene que responder rápido y sin caídas. Un hosting WordPress con monitoreo y soporte de servidores 24/7 te da esa estabilidad.
- Para cobrar de verdad, un contrato de Webpay Plus con Transbank. Para instalar y probar el plugin no lo necesitas.
Paso 1: instala el plugin oficial de Transbank
- En el panel de WordPress, ve a Plugins › Añadir nuevo plugin.
- Busca Transbank Webpay. El autor debe ser Transbank Developers: es el plugin oficial.
- Haz clic en Instalar ahora y luego en Activar.
Desconfía de plugins de Webpay de autores desconocidos o descargados de otros sitios: manejan pagos de tus clientes.
Paso 2: activa Webpay Plus
- Ve a WooCommerce › Ajustes › Pagos.
- Vas a ver dos medios nuevos: Transbank Webpay Plus (pagos con tarjeta en cada compra) y Webpay Oneclick (para guardar la tarjeta del cliente y pagar en un clic). Para empezar, usa Webpay Plus.
- Entra a la configuración de Transbank Webpay Plus y marca Activo.
- En Ambiente, deja Integración (el ambiente de pruebas).
- Revisa la Descripción que verán tus clientes al pagar y guarda los cambios.
En el ambiente de integración, el plugin usa credenciales de prueba públicas de Transbank, así que no necesitas ingresar nada más para probar.
Paso 3: haz una compra de prueba
- En tu tienda, agrega un producto al carrito y ve a pagar.
- Elige Webpay como medio de pago y confirma el pedido.
- Tu tienda te lleva al formulario de pago de Webpay en el ambiente de integración.
- Paga con una de las tarjetas de prueba que publica Transbank en su guía para desarrolladores (sección “Tarjetas de prueba”). Ahí también están los datos para simular un pago rechazado.
- Al volver a tu tienda, revisa en WooCommerce › Pedidos que el pedido haya quedado pagado, y que te hayan llegado los correos de confirmación.
Prueba también un pago rechazado y una compra cancelada, para ver qué mensaje recibe el cliente en cada caso.
Paso 4: pasa a producción
Cuando tengas tu contrato de Webpay Plus, Transbank te entrega tu código de comercio y tu llave secreta (API Key). Para empezar a cobrar:
- Sigue el proceso de puesta en producción que indica Transbank en su guía para desarrolladores y en la página del plugin para WooCommerce.
- En la configuración de Transbank Webpay Plus, cambia el Ambiente a Producción.
- Ingresa el Código de Comercio Producción y la API Key (llave secreta) producción.
- Guarda los cambios y haz una compra real por un monto bajo para confirmar que todo funciona.
Guarda tu llave secreta como una contraseña: no la compartas por correo ni la publiques. Si crees que se filtró, pide una nueva a Transbank.
Otros ajustes útiles
- Order Status: el estado en que queda el pedido después del pago (por ejemplo, “Procesando”). Si vendes productos que se despachan, déjalo en “Procesando” hasta que los envíes.
- Formato de orden de compra: el código con que el pedido aparece en Transbank. El formato por defecto incluye el número de pedido de WooCommerce, lo que facilita cruzar la información.
Problemas comunes
| Problema | Causa probable | Solución |
|---|---|---|
| No aparece Webpay al pagar | El medio de pago no está activo | Marca Activo en Ajustes › Pagos |
| “Ocurrió un error al intentar conectar con WebPay Plus” | Tu servidor no logra conectarse con Transbank | Revisa que tu hosting permita conexiones salientes y tenga los certificados al día |
| El pago se aprueba pero el pedido queda pendiente | El regreso desde Webpay no llegó a tu tienda (caché, firewall o redirecciones) | Excluye las páginas de pago de la caché y revisa que tu sitio no tenga bucles de redirección |
| En producción rechaza todas las transacciones | Código de comercio o llave secreta equivocados, o ambiente mal elegido | Revisa que el ambiente sea Producción y copia de nuevo las credenciales |
Si tu tienda tiene problemas de redirecciones, revisa ERR_TOO_MANY_REDIRECTS en WordPress.
¿Necesitas ayuda con tu tienda?
Si tu tienda necesita un hosting más estable para recibir pagos, o quieres traerla desde otro proveedor, escríbenos: la migración es gratis.
Quiero agregar Webpay a mi tienda
Preguntas frecuentes
Sí. El plugin oficial de Transbank es gratuito. Lo que cobra Transbank es la comisión por cada venta, según tu contrato.
No. El ambiente de integración funciona con credenciales de prueba públicas y tarjetas de prueba. El contrato lo necesitas para cobrar pagos reales.
En la guía para desarrolladores de Transbank, en la sección “Tarjetas de prueba”. Ahí están las tarjetas para simular pagos aprobados y rechazados.
Webpay Plus pide los datos de la tarjeta en cada compra. Oneclick permite que el cliente guarde su tarjeta para pagar en un clic en las siguientes compras.
Sí, siempre que tu sitio tenga SSL, pueda conectarse con los servidores de Transbank y responda de forma estable. Si tu hosting se cae o es lento, los pagos pueden quedar a medio camino.
Sigue leyendo
- Cómo instalar WooCommerce paso a paso
- Cómo configurar el SMTP en WordPress
- Hosting WordPress o hosting normal: cuál te conviene
Por Mauricio Zalles, Webmaster de Znet-Hosting. Actualizado el 18 de octubre de 2026.