Integrar Webpay en una tienda online implica más que instalar una extensión y agregar un botón. Hay que comprobar que la integración sea compatible con la plataforma, habilitar la cuenta correspondiente, configurar el retorno del pago y probar qué ve el comprador y qué recibe el equipo cuando una transacción queda aprobada, rechazada o pendiente.
Los pasos exactos dependen de la modalidad ofrecida por el proveedor, la versión de la plataforma y las condiciones vigentes de la cuenta. Antes de comenzar, consulta la documentación oficial de Transbank y la del conector que utilizarás. No compartas credenciales en chats o documentos públicos ni uses datos de producción en un entorno de prueba.
Antes de instalar: confirma el alcance
Identifica si tu tienda usa Shopify o WooCommerce y qué versión, tema y extensiones están activas. En Shopify, verifica qué integraciones de pago están disponibles para tu país y plan, y cuáles son sus requisitos. En WooCommerce, confirma que el plugin elegido sea compatible con la versión de WordPress y WooCommerce instalada, que tenga mantención vigente y que provenga de una fuente confiable.
Después, confirma qué modalidad de Webpay contratarás y qué pasos de habilitación requiere. Los requisitos, tarifas, abonos y condiciones comerciales los define el proveedor y pueden variar, así que revísalos directamente antes de presupuestar. Pregunta qué datos de comercio se necesitan, cuánto toma la habilitación y qué ambiente de prueba estará disponible.
También conviene preparar una compra de prueba. Define un producto simple, un monto de ensayo y una dirección controlada, sin despachar un pedido real. Decide quién observará la tienda, el panel de pagos y los correos durante el proceso. Así podrás contrastar el resultado que reporta el proveedor con el estado que queda guardado en la orden.
Integrar Webpay en Shopify
En Shopify, revisa los proveedores y métodos disponibles desde la administración de pagos. La disponibilidad de una opción y el flujo de configuración pueden cambiar, por lo que debes seguir las instrucciones actuales de Shopify y de Transbank o del integrador autorizado que corresponda. Si la conexión requiere una aplicación, comprueba quién la mantiene, qué permisos solicita y si agrega costos o condiciones de servicio.
Completa la habilitación con los datos de tu comercio y sigue los pasos de conexión indicados por el proveedor. Configura el método para que aparezca con un nombre reconocible en el checkout y verifica que la moneda, el estado de pago y los avisos se muestren correctamente. No agregues código de pago propio al tema si la integración oficial entrega el flujo y los controles necesarios.
Si utilizas aplicaciones para inventario, despacho o notificaciones, verifica que reciban la orden en el momento correcto. Una compra no debería marcarse como pagada solo porque el navegador volvió a una página de confirmación; el estado debe corresponder a la respuesta válida de la integración. Confirma cómo se notifican pagos pendientes, errores y reembolsos en tu configuración.
Integrar Webpay en WooCommerce
En WooCommerce, selecciona una extensión compatible con la versión de tu tienda y revisa su documentación, fecha de actualización y soporte. Comprueba también que el proveedor indique claramente cómo se conecta con Webpay y qué credenciales se necesitan. Evita instalar paquetes de procedencia dudosa o que pidan información ajena al proceso.
Haz una copia de respaldo antes de cambiar extensiones o ajustes de pago. Instala y configura el conector siguiendo su guía y, si tu sitio tiene una copia de pruebas, comienza ahí. Completa los campos de comercio y ambiente de acuerdo con las instrucciones del proveedor; guarda los secretos en el panel seguro y restringe su acceso al equipo que administra la tienda.
Revisa las páginas de retorno, los estados de pedido y los registros de la integración. Si cambias una opción de checkout, prueba la experiencia en computador y celular. Una extensión puede interactuar con el tema, caché, seguridad u otros plugins; por eso es importante revisar el sitio después de instalarla y no aplicar actualizaciones críticas directamente en producción sin una comprobación.
Prueba los casos que suelen olvidarse
Completa una transacción aprobada en el ambiente indicado para pruebas. Comprueba que el pedido aparezca una sola vez, tenga el estado esperado y conserve el resumen, monto y referencia necesarios para conciliarlo. Verifica la confirmación que recibe el comprador y la notificación que recibe el equipo. Revisa también que no se genere un despacho antes de confirmar el pago según tu proceso.
Prueba una operación rechazada o cancelada y observa si el carro sigue disponible para intentar nuevamente. Confirma qué sucede cuando la persona cierra la ventana, demora en volver a la tienda o pierde conexión. Los mensajes deben ayudarle a entender si hubo un cobro y qué paso seguir, sin afirmar un resultado que la tienda no puede confirmar.
Consulta cómo se gestionan anulaciones y devoluciones desde el panel y cómo se reflejan en la orden. Comprueba si el equipo puede identificar pagos duplicados o pedidos que requieren revisión manual. Registra un procedimiento breve con las pantallas que se revisan y quién puede resolver una diferencia. Las condiciones para estas operaciones dependen del proveedor y de la integración, así que sigue sus instrucciones vigentes.
Seguridad y continuidad
Usa la integración oficial o un conector confiable y mantén actualizados la plataforma, el plugin y sus dependencias. Protege las cuentas con contraseñas únicas y permisos limitados. No almacenes números de tarjeta ni códigos sensibles en formularios, hojas de cálculo o registros de la tienda. El checkout debe enviar al cliente al flujo autorizado por la integración.
Guarda respaldo antes de cambios importantes y define quién revisa alertas y actualizaciones. En WooCommerce, confirma que hosting y respaldos estén cubiertos. En Shopify, mantén el control de la cuenta propietaria y revisa los accesos de aplicaciones conectadas. En ambos casos, documenta dónde consultar las instrucciones, cómo pausar el método si falla y a quién contactar con el proveedor.
Costos y preparación del lanzamiento
El costo total puede considerar desarrollo o configuración, extensión o aplicación, soporte, plan de plataforma y condiciones comerciales del proveedor de pago. No hay una tarifa o comisión única que se aplique a todos los comercios; verifica los valores vigentes directamente y revisa también plazos de abono, requisitos y eventuales costos de terceros. Solicita una cotización si necesitas instalación y pruebas, y confirma si incluye IVA.
Antes de abrir, repite el recorrido en móvil, revisa el texto junto al medio de pago y confirma los correos. Asegúrate de que la tienda explique qué opciones acepta y qué hacer si la transacción falla. Informa al equipo cómo validar una orden y dónde consultar el estado en el panel del proveedor. Después del lanzamiento, monitorea las primeras órdenes y contrasta los registros para detectar problemas a tiempo.
Si estás preparando una tienda, revisa el servicio de tiendas online de Pixer y la guía Shopify o WooCommerce en Chile: cuál elegir. Una integración bien probada conecta checkout, orden y operación diaria, y deja claro qué hacer cuando una compra no sigue el camino esperado.
