Integrar Webpay (Transbank) en WooCommerce: certificación, Oneclick y los errores típicos

En Chile, pagar online con tarjeta es, para la mayoría, Webpay de Transbank. Si vendes a consumidores o a clientes que pagan al contado, en algún momento vas a integrarlo. Suena a instalar un plugin y listo, y en parte lo es —hay un plugin oficial—, pero el detalle que decide si funciona en producción está en la certificación, en qué Webpay usas y, sobre todo, en entender que en B2B la tarjeta es solo uno de varios métodos de pago.

Usa el plugin oficial, no un fork

El plugin oficial es Transbank Webpay Plus REST, mantenido por TransbankDevelopers y publicado en el repositorio de WordPress. Hay versiones antiguas dando vueltas —el plugin previo está marcado como obsoleto— y forks de terceros: ignóralos. La pasarela de pago es lo último donde quieres código sin mantención, porque cada cambio de Transbank o de seguridad te deja expuesto. Requisitos base del plugin actual: sitio con HTTPS, WooCommerce reciente y PHP moderno; sin HTTPS no hay Webpay.

Integración y producción son dos ambientes distintos

El plugin trae dos ambientes. Integración viene preconfigurado: usa tarjetas de prueba y credenciales de testing, sin dinero real, para que pruebes todo el flujo antes de salir. Producción usa transacciones reales y exige pasar por la validación de Transbank. El error clásico es desarrollar en integración, dar por listo, y descubrir en el lanzamiento que faltaba el proceso de producción.

Para pasar a producción necesitas tu propio código de comercio y tu API Key Secret de producción. El camino: completas el formulario de validación de Transbank, soporte revisa, y si está todo correcto te notifican la conformidad y te entregan las credenciales de producción. Recién ahí cambias el ambiente en el plugin, cargas el código de comercio y la llave reales, y cierras con una transacción real de prueba para confirmar que todo quedó operativo. No es instantáneo: es un trámite con Transbank que conviene iniciar con tiempo, no el día antes de lanzar.

Webpay Plus, Oneclick y las alternativas

Webpay Plus es el pago puntual: el cliente paga ese pedido, una vez. Es lo que cubre el grueso de las ventas. Oneclick es otra cosa: el cliente inscribe su tarjeta una vez y después paga con un clic, sin volver a digitarla —pensado para recompra y pagos recurrentes—. Es un producto aparte de Transbank, con su propia habilitación; según la versión del plugin puede estar incluido o requerir integración propia. Para un mayorista cuyo cliente recompra el mismo pedido cada semana, Oneclick reduce fricción de verdad, pero es una decisión consciente, no algo que viene gratis con Plus.

Webpay no tiene por qué ser el único método. Flow, Khipu —que automatiza la transferencia bancaria— y Mercado Pago conviven con Webpay y cubren clientes o casos que la tarjeta no resuelve. Tener más de un medio evita que una caída de la pasarela te deje sin cobrar.

Dónde se rompe en producción

La conciliación de estados. Webpay devuelve aprobado, rechazado o un timeout sin respuesta clara. El pedido tiene que reflejar exactamente eso: un pago rechazado que queda como pagado despacha gratis; un aprobado que no se registró por un timeout deja al cliente cobrado y sin pedido. El manejo de los estados de retorno —incluido el caso en que el cliente cierra la ventana a mitad de pago— es donde un plugin mal configurado falla.

Reembolsos y anulaciones. El plugin oficial soporta anulaciones y reembolsos, con una ventana de tiempo para consultar y revertir la transacción. Tenerlo conectado evita gestionar cada devolución por fuera, a mano, con Transbank.

Compatibilidad. El checkout en bloques (WooCommerce Blocks), la versión de PHP y de WooCommerce, y otros plugins de checkout pueden chocar con la pasarela. La integración hay que probarla en el checkout real, no solo en una compra de prueba limpia.

El punto B2B: la tarjeta no es para todos. Tu cliente con crédito no paga con Webpay: paga contra factura a 30 o 60 días. Ofrecerle la pasarela al que siempre operó a crédito es fricción; cobrarle con tarjeta, directamente un error. Webpay tiene que mostrarse a quien paga al contado, y los métodos de pago se eligen según quién compra. Eso conecta con cómo está armado el checkout B2B.

Qué usar y cuándo

Método	Para qué	A tener en cuenta
Webpay Plus	Pago puntual con tarjeta, el caso general.	Requiere certificación y paso a producción con Transbank.
Webpay Oneclick	Recompra: tarjeta inscrita, pago en un clic.	Producto aparte; habilitación e integración propias.
Flow / Mercado Pago	Alternativa o respaldo a Webpay.	Otra conciliación que mantener; útil para no depender de una sola pasarela.
Khipu	Transferencia bancaria automatizada.	Cubre al que paga por banco sin enviar comprobante a mano.

La recomendación

Integra Webpay con el plugin REST oficial, certifica en serio —integración primero, validación con Transbank, producción con tu código de comercio, tu API Key Secret y la transacción real de cierre—, y elige entre Plus y Oneclick según si tus clientes recompran. Maneja bien los estados de retorno para que el pedido nunca mienta sobre si se pagó. Y, lo más importante en B2B: trata Webpay como un método entre varios. El que paga al contado va por la pasarela; el cliente con crédito va contra factura. Mostrarle a cada uno lo que le corresponde es lo que hace que el pago en la web no te haga perder las condiciones que ya tenías.

Una agencia instala el plugin, lo prueba en integración y lo da por listo —hasta que el día de lanzamiento no hay credenciales de producción o el primer pago real se cae—. Webpay bien integrado es certificación hecha a tiempo, estados conciliados y la pasarela ofrecida solo a quien paga con tarjeta. Si vas a salir a vender con Webpay y manejas además clientes a crédito, un diagnóstico ordena qué medio va para quién antes de tocar el checkout.