Webpay es la marca de pagos de Transbank que procesa tarjetas de crédito, débito y Redcompra en Chile. Webpay Plus es la versión para checkout propio: tu tienda crea la transacción, redirige al comprador a pagar y confirma el resultado con una llamada a la API. Integrarlo toma código, no solo un contrato.
Qué es Webpay y en qué se diferencia de Transbank
Webpay es el nombre comercial de la familia de productos de pago que opera Transbank, el adquirente que procesa transacciones con tarjeta por cuenta de los comercios chilenos. La confusión entre ambos nombres es habitual: Transbank es la empresa con la que firmas contrato y pasas la evaluación comercial; Webpay es el producto concreto que tu equipo de desarrollo integra en el checkout para cobrar. Si buscas los requisitos de afiliación, el ciclo de liquidación y el trámite comercial completo, esa parte está cubierta en nuestra guía de Transbank; esta guía se enfoca en la integración técnica de Webpay una vez que ya tienes el código de comercio.
Webpay Plus, Webpay Plus Mall y Oneclick Mall: qué versión necesita tu tienda
No todos los negocios integran el mismo producto Webpay. La diferencia está en cómo se reparte el pago y si necesitas guardar la tarjeta para cobros futuros.
| Producto | Cómo cobra | Para quién sirve |
|---|---|---|
| Webpay Plus | Redirige al comprador a pagar una vez; no guarda datos de la tarjeta | Un ecommerce con una sola razón social que cobra pagos puntuales |
| Webpay Plus Mall | Reparte un mismo pago entre varios comercios afiliados bajo un código de mall | Marketplaces o plataformas que agrupan a distintos vendedores en un carrito |
| Oneclick Mall | Tokeniza la tarjeta la primera vez y cobra sin redirigir en las compras siguientes | Negocios con cobros recurrentes o suscripciones que quieren evitar que el cliente reingrese sus datos |
Si tu tienda vende directo al público bajo una sola razón social, Webpay Plus es el punto de partida. Oneclick Mall solo tiene sentido cuando ya operas con suscripciones o pagos recurrentes; integrarlo sin ese caso de uso agrega complejidad de tokenización que no vas a aprovechar.
Cómo integrar Webpay Plus paso a paso
La integración técnica sigue el mismo patrón sin importar el lenguaje que uses:
- Crear la transacción. Tu servidor llama al endpoint de creación con el monto, un identificador único de la orden (buyOrder), un identificador de sesión y la URL de retorno. Webpay responde con un token y una URL de pago.
- Redirigir al comprador. El navegador del cliente sale de tu sitio hacia la pantalla de Webpay, donde ingresa los datos de su tarjeta o Redcompra.
- Recibir el token de vuelta. Tras el intento de pago, Webpay redirige al comprador a tu URL de retorno junto con el token de la transacción, sin importar si el pago fue aprobado o rechazado.
- Confirmar la transacción (commit). Tu servidor hace un segundo llamado a la API con ese token para obtener el resultado final. Solo el estado "AUTHORIZED" confirma que el banco emisor aprobó el cobro; cualquier otro estado significa que el pedido no está pagado.
El error clásico acá es dar el pedido por pagado apenas el comprador vuelve a tu sitio, sin esperar la respuesta del commit: el navegador puede volver aunque el pago haya sido rechazado o el proceso se haya interrumpido a medio camino.
Plugins y SDKs oficiales para no integrar desde cero
Si tu tienda corre sobre una plataforma existente, la integración manual con la API no siempre es necesaria. Transbank Developers publica plugins certificados para WooCommerce y PrestaShop, además de SDKs oficiales que cubren los lenguajes más usados en ecommerce.
Si tu tienda corre en Shopify, la integración pasa por una app de pago que conecte con la API de Webpay, ya que Shopify no ofrece a Transbank como pasarela nativa en su panel: revisa nuestra guía de Shopify en Chile antes de elegir esa ruta.
Cómo probar Webpay antes de salir a producción
Antes de pedir las credenciales de producción, Transbank Developers habilita un ambiente de integración público con endpoints separados de los de producción, sin necesidad de tener el contrato comercial firmado todavía. Ese ambiente entrega tarjetas, RUT y clave de prueba documentados en el propio sitio de Transbank Developers, y simula tanto transacciones aprobadas como rechazadas.
El error clásico acá es probar solo el camino feliz. Si tu equipo únicamente simula pagos aprobados, el checkout llega a producción sin manejar lo que pasa cuando el banco rechaza la tarjeta o el comprador cierra la pestaña de pago a medio camino, y ese comprador se queda sin saber si su compra se concretó.
Errores comunes al integrar Webpay en tu tienda
El primero es mezclar credenciales del ambiente de integración con las de producción, o dejar las de prueba activas por descuido: la tienda parece funcionar, pero ningún cobro es real hasta que alguien detecta el error, casi siempre cuando el primer cliente reclama porque nunca recibió su producto.
El segundo es reutilizar el mismo buyOrder para reintentos de una compra fallida. Webpay lo trata como una orden nueva o la rechaza según el caso, y tu sistema termina con registros duplicados o inconsistentes que complican la conciliación contable.
El tercero es no definir qué hacer si el comprador nunca vuelve a tu URL de retorno, por ejemplo si cierra la pestaña antes de terminar el pago. Sin un proceso que consulte el estado de esas transacciones huérfanas, quedan pedidos en un limbo que ni se confirman ni se cancelan.
Cuánto cuesta usar Webpay y cómo se liquida el pago
Transbank no publica una tarifa única por transacción para Webpay: la comisión se negocia según el rubro, el volumen de venta y el riesgo de contracargo de tu negocio, y se define al cierre de la evaluación comercial. Si además estás comparando Webpay contra otras pasarelas que operan en Chile, esa comparación completa está en nuestra guía de pasarelas de pago. La liquidación del dinero tampoco es instantánea: sigue el ciclo pactado en tu contrato con Transbank, que se expresa en días hábiles.
Qué hacer con esto
Antes de escribir código, define qué producto Webpay necesitas: Webpay Plus si vendes bajo una sola razón social, Webpay Plus Mall si tu plataforma agrupa a varios vendedores, u Oneclick Mall si cobras suscripciones. Con eso claro, arma el flujo completo en el ambiente de integración, incluyendo el camino de rechazo y el de abandono a medio pago, no solo el camino aprobado. Antes de pedir credenciales de producción, confirma con tu equipo técnico que el paso de confirmación (commit) revisa el estado "AUTHORIZED" y que existe un proceso para las transacciones que quedan huérfanas cuando el comprador nunca vuelve.
Preguntas frecuentes
¿Qué es Webpay Plus?
Es el producto de Webpay para un ecommerce con una sola razón social que cobra pagos puntuales con tarjeta o Redcompra: el comprador es redirigido a pagar y no queda ninguna tarjeta almacenada para cobros futuros.
¿Cómo funciona Webpay?
Tu tienda crea la transacción con la API, redirige al comprador a la pantalla de pago de Webpay, y cuando este vuelve a tu sitio, tu servidor confirma el resultado con un segundo llamado a la API. Solo esa confirmación determina si el pedido quedó pagado.
¿Cómo integro Webpay en mi tienda online?
Depende de tu plataforma: si usas WooCommerce o PrestaShop, un plugin certificado de Transbank Developers resuelve la mayor parte del trabajo; si desarrollas a medida, un SDK oficial en PHP, Java, .NET, Node.js, Python o Ruby cubre el flujo de creación y confirmación de la transacción.
¿Webpay y Transbank son lo mismo?
No exactamente. Transbank es la empresa que opera como adquirente y con la que firmas el contrato comercial; Webpay es el nombre de su producto de pago, con variantes como Webpay Plus, Webpay Plus Mall y Oneclick Mall según cómo necesites cobrar.
Integrar Webpay no termina cuando el ambiente de pruebas devuelve "AUTHORIZED": termina cuando tu checkout maneja igual de bien el pago aprobado, el rechazado y el que el comprador abandonó a medio camino.
