Integrar Webpay en WooCommerce: guía 2026 paso a paso

Integrar Webpay en una tienda WooCommerce es hoy un proceso más ordenado de lo que era hace unos años: existe un plugin oficial mantenido por Transbank, el ambiente de pruebas viene preconfigurado y el paso a producción se gestiona desde el propio portal del comercio. Lo que sigue es el proceso completo, en el orden en que conviene hacerlo, con los chequeos que aplico en tiendas reales antes de dar una integración por terminada.

El orden importa por una razón práctica: la parte comercial (el contrato con Transbank) y la parte técnica (el plugin y las pruebas) corren por carriles separados, y puedes avanzar la segunda mientras esperas la primera.

La respuesta corta

#	Paso	Dónde se hace
1	Contratar Webpay Plus	Sitio de Transbank, con el RUT del negocio
2	Dejar el sitio al día	SSL activo, WordPress 6.3 o superior, PHP 8.2 o superior
3	Instalar el plugin oficial	”Transbank Webpay”, repositorio de WordPress
4	Probar en el ambiente de integración	Tarjetas de prueba, flujo aprobado y rechazado
5	Pasar a producción	Código de comercio y Api Key Secret desde el Portal de Transbank
6	Validar con una compra real	Transacción desde $50 y revisión del abono

El contrato con Transbank parte primero

Webpay no se activa instalando un plugin: necesitas un contrato con Transbank. Se tramita en su sitio con el RUT del negocio, una cuenta bancaria donde recibir los abonos y los datos de la empresa. De ese contrato salen dos cosas que vas a usar más adelante: tu código de comercio y las condiciones comerciales (la comisión por venta y el plazo de abono quedan fijados ahí, así que revísalos en tu contrato y no en lo que diga un tutorial).

El trámite depende de Transbank y toma días, no horas. Por eso conviene iniciarlo antes de tocar la tienda: todo el trabajo técnico de los pasos siguientes se puede hacer y probar completo sin que el contrato esté listo.

Antes del plugin: deja el sitio al día

El plugin oficial exige WordPress 6.3 o superior y PHP 8.2 o superior, y una pasarela de pago sin certificado SSL no es opción. Tres chequeos antes de instalar nada:

• SSL activo y renovándose solo. Si tu tienda todavía muestra “no seguro” en el navegador, ese es el primer arreglo.
• Versión de PHP. Muchas tiendas con años de operación siguen en PHP 7.4. Subir de versión es el paso con más riesgo de romper otra cosa (temas y plugins viejos), así que pruébalo primero en una copia del sitio, no directo en la tienda que vende.
• Respaldo completo de archivos y base de datos antes de empezar.

Paso 1: instala el plugin oficial de Transbank para WooCommerce

En el repositorio de WordPress el plugin se llama Transbank Webpay y lo mantiene el equipo de Transbank (versión 1.14.0 al momento de escribir esto). Se instala desde el propio panel: Plugins, Añadir nuevo, buscar “Transbank Webpay”, instalar y activar.

El plugin trae dos productos: Webpay Plus (el pago con tarjeta que la mayoría de los compradores conoce) y Webpay Oneclick (tarjeta guardada para compras posteriores). Mi recomendación es partir solo con Webpay Plus; Oneclick es una decisión de negocio distinta, se habilita aparte con Transbank y se puede sumar después. Con el plugin activo, Webpay Plus aparece como medio de pago en WooCommerce, Ajustes, Pagos: actívalo ahí.

Paso 2: prueba Webpay en el ambiente de integración

Aquí está la parte que más veces he visto saltarse, y es justo la que evita sustos. El plugin viene apuntando de fábrica al ambiente de integración de Transbank: un entorno que replica el real, donde las compras no mueven dinero. Usa un código de comercio de pruebas compartido (597055555532), así que puedes probar el flujo completo hoy mismo, con o sin contrato.

Haz una compra de prueba en tu propia tienda y págala con la tarjeta de prueba de Transbank:

• VISA 4051 8856 0044 6623, CVV 123, cualquier fecha de vencimiento futura.
• Cuando el formulario pida autenticación bancaria, el banco simulado acepta RUT 11.111.111-1 y clave 123.

Con eso obtienes una compra aprobada. Prueba también el caso contrario: la Mastercard de prueba 5186 0595 5959 0568 genera un rechazo. En cada caso revisa lo que le pasa a la tienda, no solo al pago: que la orden aprobada quede en el estado correcto y descuente stock, que la rechazada quede como fallida sin descontar nada, y que los correos de confirmación lleguen y digan lo que corresponde.

Paso 3: pasa a producción

Con el contrato listo, Transbank te asigna el código de comercio de tu negocio y, aprobada la validación, te entrega la Api Key Secret del ambiente de producción; ambas cosas se gestionan desde su portal. En la configuración del plugin cambias el ambiente de integración a producción y pegas ambos datos.

Esa llave es una credencial con acceso a tus cobros: trátala como una contraseña. No la dejes en correos, tickets de soporte ni documentos compartidos.

Paso 4: valida con una compra real

Transbank contempla una transacción real de validación desde $50. Hazla: compra en tu propia tienda con una tarjeta real, verifica que la orden llegó bien y después revisa que el abono aparezca en la cuenta del negocio dentro del plazo de tu contrato.

Mi criterio es no dar por cerrada una integración hasta ver una venta real completa: pago aprobado, orden correcta en la tienda y plata abonada en la cuenta. Recién ahí doy la integración por terminada.

Los chequeos que evitan perder ventas después

La diferencia entre una integración instalada y una integración probada aparece con el tiempo. Estos son los puntos donde he visto fallar tiendas que “ya estaban listas”:

• El retorno de Webpay y la caché. Cuando el cliente paga, Webpay lo devuelve a una URL de tu tienda que confirma la orden. Si usas un plugin de caché o un firewall de aplicación, excluye esas URLs de retorno: la falla más ingrata de diagnosticar es un pago cobrado cuya orden quedó sin confirmar en la tienda.
• El cliente que no vuelve. Si alguien llega al formulario de pago y cierra la ventana, la orden queda pendiente. Define qué hace tu tienda con esas órdenes (cancelación automática o revisión manual) para que el stock no quede tomado por compras que no ocurrieron.
• El rechazo probado. Una tienda que solo probó el caso feliz descubre los problemas con el primer cliente al que le rechazan la tarjeta. Ese caso ya lo probaste gratis en integración; repítelo si cambias algo del checkout.
• Las actualizaciones. El plugin de Transbank, WooCommerce y PHP siguen evolucionando. En una tienda que vende, las actualizaciones se prueban primero en una copia, con una compra de integración de por medio, y después se aplican en producción.

Una integración de Webpay que dejé en producción en 2020 sigue operando hoy, en una tienda que va en su séptimo año sobre la misma plataforma. Buena parte de esta lista viene de mantener esa tienda y otras tiendas WooCommerce en producción.

Preguntas frecuentes

¿Puedo probar Webpay sin tener el contrato con Transbank?

Sí. El ambiente de integración usa un código de comercio de pruebas compartido y tarjetas de prueba, así que puedes dejar el flujo completo funcionando en tu WooCommerce antes de que el contrato esté listo. Lo único que no puedes hacer sin contrato es pasar a producción.

¿El mismo plugin sirve para Webpay Oneclick?

Sí, el plugin oficial trae Webpay Plus y Webpay Oneclick. Son productos distintos: Oneclick guarda la tarjeta del cliente para compras posteriores y su habilitación se gestiona aparte con Transbank. Para una tienda que recién empieza a cobrar en línea, Webpay Plus es el punto de partida.

¿Puedo tener Webpay y otro medio de pago a la vez?

Sí. WooCommerce permite varias pasarelas conviviendo: Webpay junto a Mercado Pago o transferencia es una configuración normal. La decisión es de negocio, por comisiones, plazos de abono y lo que usan tus clientes. Y si la duda es más de fondo, plataforma propia o arrendada, en WordPress vs Shopify en Chile está la cuenta completa a 12 meses, comisiones incluidas.

Si prefieres delegarlo

Integrar Webpay es perfectamente hacible por tu cuenta siguiendo esta guía; el trabajo fino está en las pruebas y en lo que pasa después, cuando la tienda ya vende. Si prefieres que lo haga alguien que lo ha hecho antes, así trabajo yo una tienda online WooCommerce con Webpay: integración probada con el flujo completo de compra y acompañamiento hasta que la primera transacción real pasa.

Fuentes: Documentación oficial de Webpay: ambientes, códigos y tarjetas de prueba, Transbank Developers · Plugin oficial Transbank Webpay, repositorio de WordPress. Ambas fuentes consultadas el 27 de agosto de 2026.