Cómo integrar Webpay Plus en tu página web: pasos y requisitos

Qué es Webpay Plus y cómo funciona

Webpay Plus es el servicio de Transbank para cobrar con tarjetas de crédito y débito dentro de un sitio web. El cliente elige sus productos en tu página, es llevado al formulario de pago de Transbank, paga allí y vuelve a tu sitio con el resultado.

Un punto importante: los datos de la tarjeta se ingresan en la página de Transbank, no en la tuya. Tu sitio nunca los ve ni los guarda, y eso simplifica mucho la seguridad.

Lo que tienes que resolver antes de programar

La integración técnica es solo una parte. Antes hay trámites comerciales que dependen del dueño del negocio, no del desarrollador:

Contratar el servicio con Transbank

El comercio contrata y habilita Webpay Plus directamente con Transbank, que evalúa la solicitud y define las condiciones y comisiones. Es un contrato entre tu empresa y Transbank.

Contar con un código de comercio

Es el identificador que Transbank asigna a tu negocio. Con él se obtienen las credenciales para operar con dinero real.

Tener claro qué vendes

Productos, servicios, reservas o cuotas. Define montos, impuestos, política de devoluciones y datos de contacto, porque deben estar visibles para tus clientes.

Un sitio listo para vender

Con catálogo o servicios claros, términos y condiciones, y un correo o WhatsApp de atención.

El flujo técnico, en simple

Aunque cada sitio tiene su propia lógica, el recorrido de un pago con Webpay Plus sigue casi siempre los mismos pasos:

1. Crear la transacción

Tu servidor le avisa a Transbank el monto y una orden de compra, y recibe un token de la transacción.

2. Redirigir al cliente

El cliente es enviado al formulario de pago de Transbank con ese token.

3. Volver al sitio

Tras pagar, o cancelar, Transbank devuelve al cliente a una dirección de tu sitio con el token.

4. Confirmar el pago

Tu servidor consulta a Transbank el resultado y lo confirma. Recién ahí el pedido se marca como pagado.

5. Registrar y avisar

Guardas la venta, envías el comprobante al cliente y descuentas el stock o confirmas la reserva.

Ambiente de pruebas y paso a producción

Transbank entrega un ambiente de integración con credenciales y tarjetas de prueba, donde se puede simular pagos aprobados y rechazados sin mover dinero. Todo el desarrollo se hace ahí.

Para pasar a producción se usan las credenciales reales de tu comercio, y Transbank puede pedir validar la integración antes de habilitarla. Los requisitos exactos los define Transbank y pueden cambiar, así que conviene revisar su documentación oficial para desarrolladores. Una vez en producción, haz una compra real de monto bajo para confirmar que todo el recorrido funciona.

Errores comunes que conviene evitar

Son fallas frecuentes en integraciones mal resueltas, y todas se pueden prevenir:

Dar el pedido por pagado sin confirmar

Volver al sitio no significa que el pago fue aprobado. Siempre hay que confirmar el resultado con Transbank desde tu servidor.

No manejar los pagos cancelados o rechazados

El cliente puede cerrar la ventana, anular o ser rechazado. El sitio debe explicarlo y dejarlo reintentar sin perder su carro.

Guardar las credenciales en el código visible

Las credenciales reales deben vivir solo en el servidor, nunca en el navegador ni en un repositorio público.

Olvidar las anulaciones y devoluciones

Define cómo se gestionan antes de vender, y que quede registro en tu sistema.

Duplicar órdenes

Si el cliente actualiza la página de retorno, el pedido no debe procesarse dos veces.

Plugin, plataforma o integración a medida

Si usas una tienda armada sobre una plataforma conocida, muchas veces existe un módulo de Webpay que basta con configurar. Es una buena opción cuando tu venta es estándar.

Cuando tu sitio tiene reservas, cuotas, abonos, planes o reglas propias, o cuando el pago debe conectarse con tu sistema de gestión, lo habitual es una integración a medida. El valor depende de cuántos flujos de pago tienes, de si hay anulaciones, de cómo se conecta con otros sistemas y del nivel de pruebas necesario; se entrega por escrito después del diagnóstico.