✅ Webpay Transbank Chile: Integración Paso a Paso [Guía 2025]

Webpay de Transbank es la pasarela de pagos más utilizada en Chile, procesando el 70% de las transacciones online del país. En esta guía te explicamos paso a paso cómo integrarla correctamente en tu tienda online.

¿Necesitas ayuda con la integración? Nuestro servicio de integración Webpay incluye certificación completa y configuración optimizada para tu eCommerce.

¿Qué es Webpay y por qué es esencial en Chile?

Webpay es la plataforma de pagos online de Transbank que permite procesar pagos con tarjetas de crédito y débito de todos los bancos chilenos. Es prácticamente obligatorio para cualquier ecommerce serio en Chile.

Ventajas de usar Webpay:

• Confianza del usuario: Logo reconocido y confiable
• Cobertura total: Todas las tarjetas chilenas
• Seguridad: Certificación PCI DSS nivel más alto
• Soporte local: Atención en español y peso chileno
• Integración bancaria: Transferencias directas a tu cuenta

"Implementar Webpay en nuestra tienda Shopify aumentó las conversiones un 40%. Los clientes confían más cuando ven el logo de Transbank."

— Caso de éxito documentado

Tipos de integración Webpay disponibles

1. Webpay Plus (más común)

Ideal para: La mayoría de tiendas online

• Pago con tarjetas de crédito y débito
• Proceso estándar de autorización
• Integración más simple
• Costo: 2.95% + IVA por transacción

2. Webpay Plus Mall

Ideal para: Marketplaces con múltiples vendedores

• Distribución automática de pagos
• Gestión de comisiones
• Reportes detallados por vendedor
• Integración más compleja

3. Oneclick Mall

Ideal para: Subscripciones y pagos recurrentes

• Pago con un click (tarjeta guardada)
• Perfecto para suscripciones
• Mejora conversión en compras repetidas
• Requiere certificación adicional

Requisitos previos para integrar Webpay

Requisitos legales y comerciales:

1. RUT de empresa vigente
2. Cuenta corriente bancaria (mismo RUT)
3. Sitio web funcionando con HTTPS
4. Términos y condiciones publicados
5. Política de privacidad actualizada
6. Información de contacto visible

Requisitos técnicos:

• Certificado SSL válido (HTTPS obligatorio)
• Plataforma compatible (Shopify, WooCommerce, custom)
• URLs de respuesta configurables
• Capacidad de recibir POST callbacks

¿Migras de WooCommerce? Nuestra migración a Shopify incluye configuración completa de Webpay optimizada desde el día uno. Ver precios de migración.

Proceso de certificación paso a paso

Paso 1: Solicitud inicial

1. Contacta a Transbank o un integrador certificado
2. Completa formulario de solicitud
3. Adjunta documentos requeridos:
   • Copia de RUT empresa
   • Certificado de vigencia
   • Poder del representante legal
   • Cartola bancaria reciente

Paso 2: Evaluación comercial

Transbank revisa:

• Solvencia financiera de la empresa
• Tipo de productos/servicios
• Volumen de ventas proyectado
• Modelo de negocio

Paso 3: Certificación técnica

1. Ambiente de integración:
   • Recibes credenciales de testing
   • Implementas integración en ambiente prueba
   • Realizas transacciones de prueba
2. Testing obligatorio:
   • Transacciones exitosas
   • Transacciones rechazadas
   • Timeouts y errores
   • Reversas y anulaciones
3. Validación por Transbank:
   • Revisión de logs
   • Verificación de URLs
   • Testing de seguridad

Paso 4: Puesta en producción

• Recibes credenciales de producción
• Migras configuración a ambiente live
• Realizas transacciones de validación final
• Transbank activa tu comercio

Integración técnica en Shopify

Opción 1: App oficial Transbank (recomendada)

La forma más simple y segura:

1. Instala la app "Transbank Webpay Plus" desde Shopify App Store
2. Configura credenciales proporcionadas por Transbank
3. Activa gateway de pago en configuración
4. Realiza transacciones de prueba

Ventajas:

• Instalación en minutos
• Mantenimiento automático
• Cumple todos los estándares de seguridad
• Soporte técnico incluido

Opción 2: Integración custom

Para casos con requerimientos específicos:

// Configuración básica Webpay Plus
const WebpayPlus = require('transbank-sdk').WebpayPlus;

WebpayPlus.configureForIntegration(
  'TU_COMMERCE_CODE',
  'TU_API_KEY'
);

// Crear transacción
const createResponse = await WebpayPlus.Transaction.create(
  buyOrder,
  sessionId, 
  amount,
  returnUrl
);

URLs de configuración importantes:

• Return URL: Donde vuelve el usuario después del pago
• Final URL: Confirmación final de la transacción
• Timeout URL: Si la transacción expira

Integración técnica en WooCommerce

Plugin oficial recomendado:

1. Descarga plugin oficial desde repositorio Transbank
2. Instala vía WordPress admin
3. Configura credenciales en WooCommerce → Payments
4. Selecciona ambiente (integración/producción)
5. Configura URLs de callback

Configuración avanzada WooCommerce:

// wp-config.php - Configuración adicional
define('WEBPAY_COMMERCE_CODE', 'tu_codigo_comercio');
define('WEBPAY_API_KEY', 'tu_api_key');
define('WEBPAY_ENVIRONMENT', 'PRODUCCION'); // o 'INTEGRACION'

Mejores prácticas de implementación

1. Seguridad

• HTTPS obligatorio: Nunca proceses pagos sin SSL
• Validación server-side: Siempre valida transacciones en tu servidor
• Logs de seguridad: Registra todos los eventos importantes
• PCI Compliance: No almacenes datos de tarjetas

2. Experiencia de usuario

• Loading states: Muestra estado durante el proceso
• Error handling: Mensajes claros en caso de error
• Responsive design: Optimiza para móvil
• Timeouts claros: Informa tiempo límite de pago

3. Manejo de errores comunes

• Timeout de transacción: Redirige a página de reintentar
• Tarjeta rechazada: Ofrece métodos alternativos
• Error de comunicación: Página de error amigable
• Abandono de pago: Email de carrito abandonado

Testing y validación

Casos de prueba obligatorios:

1. Transacción exitosa:
   • Usar tarjetas de prueba proporcionadas
   • Verificar confirmación en ambos sistemas
   • Validar generación de orden
2. Transacción rechazada:
   • Usar números de prueba que generan rechazo
   • Verificar mensaje de error al usuario
   • Confirmar que no se crea orden
3. Timeout de pago:
   • Simular abandono durante proceso
   • Verificar liberación de stock
   • Confirmar redirección correcta

Tarjetas de prueba Transbank:

• 4051885600446623: Visa aprobada
• 5186059559590568: Mastercard aprobada
• 4444444444444444: Visa rechazada
• 5555555555554444: Mastercard rechazada

Costos y comisiones Webpay

Estructura de costos típica:

• Webpay Plus: 2.95% + IVA por transacción
• Setup inicial: $50.000 - $150.000 CLP
• Mantención mensual: $15.000 - $30.000 CLP
• Certificación técnica: $80.000 - $200.000 CLP

Factores que afectan las comisiones:

• Volumen mensual de transacciones
• Tipo de industria/productos
• Historial crediticio de la empresa
• Integrador utilizado

Troubleshooting: Problemas comunes

Error: "Comercio no válido"

• Causa: Código de comercio incorrecto
• Solución: Verificar credenciales con Transbank

Error: "Firma inválida"

• Causa: API Key incorrecta o formato de datos malo
• Solución: Revisar implementación de firma

Error: "URL de retorno no válida"

• Causa: URL no registrada en Transbank
• Solución: Registrar URLs correctas

Transacciones que no se confirman

• Causa: Callback no implementado correctamente
• Solución: Revisar endpoint de confirmación

Optimización para conversiones

1. Trust signals

• Logo de Transbank visible en checkout
• Iconos de tarjetas aceptadas
• Mensaje de seguridad SSL
• Garantía de devolución clara

2. Checkout optimizado

• Un solo paso para información de pago
• Guest checkout disponible
• Auto-completado de formularios
• Campos mínimos requeridos

3. Mobile optimization

• Diseño responsive del checkout
• Botones de tamaño táctil
• Loading states claros
• Teclado numérico para tarjetas

Mantenimiento y monitoreo

KPIs importantes a monitorear:

• Tasa de aprobación: % de transacciones exitosas
• Tasa de abandono: % que abandona en Webpay
• Tiempo promedio de pago: Duración del proceso
• Errores por tipo: Clasificación de fallos

Mantenimiento regular:

• Actualizar plugins/SDKs regularmente
• Revisar logs de errores semanalmente
• Testing mensual de transacciones
• Backup de configuraciones

Conclusión

Implementar Webpay correctamente es esencial para el éxito de tu ecommerce en Chile. Aunque el proceso puede parecer complejo, seguir esta guía paso a paso te asegura una integración exitosa.

Puntos clave para recordar:

• La certificación con Transbank puede tomar 2-4 semanas
• Usa siempre integraciones oficiales cuando estén disponibles
• Testing exhaustivo es obligatorio antes de producción
• Optimiza la experiencia de checkout para maximizar conversiones
• Monitorea KPIs regularmente para detectar problemas

Una integración Webpay bien implementada no solo permite procesar pagos - aumenta la confianza del cliente y mejora significativamente las conversiones.