Errores WebPay en WooCommerce: 350, 21 y más

Integrar WebPay Plus con WooCommerce en Chile

WebPay Plus es la pasarela de pagos más usada en Chile. Con más del 70% de participación en pagos electrónicos en Chile, según datos de la industria, su presencia en el checkout genera confianza inmediata en los compradores y mejora las conversiones.

Si además necesitas conectar tu ERP con WooCommerce, consulta nuestra guía sobre integración Softland WooCommerce.

Acá cubrimos los requisitos, la certificación, la configuración del plugin oficial y los errores más comunes. Paso a paso, sin tecnicismos.

El proceso completo de integración suele tomar entre 1 y 2 semanas, dependiendo de la validación de Transbank. No requiere costos de instalación inicial, solo pagas comisión por cada transacción. Una vez en marcha, tu tienda podrá aceptar tarjetas de crédito, débito Redcompra y prepago, lo que te dará acceso al 90% de los métodos de pago preferidos por los chilenos.

¿Qué es WebPay Plus y por qué es clave para tu e-commerce en Chile?

WebPay Plus es la evolución moderna del sistema de pagos de Transbank, empresa que desde hace décadas maneja gran parte de la infraestructura financiera en Chile. Antes, el sistema era un simple enlace donde el cliente ingresaba manualmente el monto de la compra. Hoy funciona como una API REST, con comunicación cifrada y procesos automáticos que se integran directamente en tu tienda.

Cómo funciona el flujo de pago

El ciclo de una transacción en WebPay Plus es siempre el mismo, y entenderlo ayuda a evitar errores:

1. Tu tienda crea la transacción con el monto e ID del pedido.
2. El cliente es redirigido al formulario seguro de Transbank.
3. Se procesa el pago (con autenticación bancaria cuando es necesario).
4. El cliente regresa a tu tienda con un token de transacción.
5. Tu sistema consulta a Transbank para confirmar el resultado.

Todo esto ocurre en cuestión de segundos, manteniendo al comprador dentro de una experiencia segura y transparente.

Ventajas frente a otras pasarelas

El liderazgo de WebPay Plus en Chile no es casualidad:

• Confiabilidad: procesa millones de pagos al día con alta disponibilidad (superior al 99%).
• Comisiones más bajas: entre 1.49% y 2.95% + IVA, mientras que Mercado Pago y Flow superan el 3%.
• Liquidación rápida: 24 horas para débito/prepago y 48 horas para crédito, sin importar el banco del comercio.
• Confianza del consumidor: estudios muestran que un comprador en Chile tiene mayor probabilidad de completar la compra al ver el logo de WebPay Plus, especialmente en rubros sensibles como turismo o servicios profesionales.

Requisitos previos para usar WebPay Plus

Antes de instalar nada, debes asegurarte de cumplir con las condiciones comerciales y técnicas que exige Transbank.

Requisitos comerciales y legales

• Persona natural con RUT

  • Ser mayor de 18 años.
  • Tener cuenta bancaria personal.
  • Límite máximo: $200.000 CLP por transacción si no tienes inicio de actividades en el SII.

• Empresa formalizada

  • RUT de empresa y giro comercial en el SII.
  • Representante legal con poderes vigentes.
  • Cuenta bancaria de empresa.
  • MCC (Merchant Category Code), que define las comisiones aplicables.

La solicitud se hace en línea en el portal de Transbank y la aprobación suele demorar 7 días hábiles.

Requisitos técnicos del servidor

• PHP 8.2 o superior (mínimo 7.4 en versiones antiguas).
• Certificado SSL válido (obligatorio).
• Extensiones de PHP: curl, json, openssl, mbstring.
• WordPress 6.4+ y WooCommerce 8.0+.
• Configuración de moneda en CLP, sin decimales, con formato chileno.

Proceso de contratación

1. Llama al 600 638 6380 o inicia la solicitud en el portal público de Transbank.
2. Envía la documentación requerida.
3. Una vez aprobado, recibirás credenciales de integración.
4. Debes pasar por un proceso de certificación obligatoria antes de poder vender con dinero real.

Paso a paso: integrar WebPay Plus en WooCommerce

1. Instalación del plugin oficial

• Ingresa a Plugins → Añadir nuevo en WordPress.
• Busca “Transbank Webpay Plus REST” y asegúrate que el autor sea TransbankDevelopers.
• Instálalo y actívalo.
• También puedes bajarlo de GitHub y subirlo manualmente como ZIP, disponible en el directorio oficial de plugins de WordPress.

La versión actual (1.11.0+) incluye soporte para WebPay Plus, OneClick (pagos recurrentes), reembolsos y compatibilidad con WooCommerce Blocks.

2. Configuración del ambiente de pruebas

• En WooCommerce → Ajustes → Pagos → WebPay Plus, selecciona “Integración”.
• Usa las credenciales de prueba: comercio 597055555532 y tarjeta VISA 4051885600446623 (CVV 123, fecha futura, RUT 11.111.111-1, clave 123).
• Realiza pruebas exitosas y rechazadas.
• El monto mínimo de prueba es $350 CLP.

3. Proceso de certificación

Envía un correo a soporte@transbank.cl con asunto “Validación WebPay Plus – [nombre de tu comercio]” incluyendo:

• Capturas del flujo completo de compra.
• Logs del sistema mostrando callbacks correctos.
• Evidencia de transacciones de prueba.

La validación demora entre 48 y 72 horas hábiles.

4. Activación en producción

• Transbank te enviará tus credenciales productivas.
• Cámbialas en el plugin y activa Producción.
• Realiza una venta real de al menos $50 CLP para validar.

Configuración avanzada y optimización

WebPay OneClick

Permite pagos con un clic para clientes recurrentes. Puede aumentar significativamente las conversiones en suscripciones y compras frecuentes.

Velocidad del checkout

• Usa cache salvo en carrito y checkout.
• Optimiza imágenes en WebP.
• Precarga recursos críticos de Transbank.
• Monitorea tiempos con PageSpeed configurado para Chile.

Experiencia del usuario

• Mensajes claros en español chileno.
• Validación automática de RUT.
• Logos de seguridad y WebPay visibles en el checkout.
• Envíos calculados por región.

Errores de WebPay en WooCommerce

Acá está la parte que más se busca y peor documentada está. Todo lo que sigue sale de la documentación oficial de Transbank Developers y del centro de ayuda de Transbank.

"Error 350" y "error 21": lo primero es la mala noticia

Son dos de las búsquedas más frecuentes sobre WebPay, y Transbank no documenta ningún error 350 ni error 21 en Webpay Plus. No están en la tabla de códigos de respuesta, ni en los errores de la API REST, ni en los errores de las máquinas POS —donde sí existen otros, como el ERROR 71 o los REINTENTE 18 y 19.

Hay blogs que afirman que el 350 significa "el banco emisor no autorizó la transacción". No hay respaldo oficial de eso, así que no lo repetimos.

Qué hacer si te aparece un número así:

1. Fíjate dónde lo ves. No es lo mismo un mensaje en el checkout del comprador que un código en los logs del plugin o en el Portal de Clientes de Transbank. Cada origen tiene su propia tabla.
2. Revisa si es el monto. El caso más común con "350" no es un código de error: es el monto mínimo de $350 CLP del ambiente de integración. Una prueba por menos de eso falla, y el mensaje se confunde con un error numerado.
3. Busca el responseCode real en los logs del plugin. Ese sí está documentado, y es la tabla que viene a continuación.

Códigos de rechazo de autorización

Cuando una transacción se rechaza, Transbank devuelve un responseCode. Acá está la trampa que casi nadie conoce: todos los comercios están configurados por defecto en "nivel 1", que agrupa rechazos distintos bajo el mismo código y por eso resulta inútil para diagnosticar.

Nivel 1, el que ves si no pediste nada:

Nivel 2, que hay que solicitar:

Para activar el nivel 2 se envía un correo a soporte@transbank.cl indicando el código de comercio. Es gratis y cambia por completo la capacidad de diagnosticar: pasas de "rechazo general" a "tarjeta vencida".

Sobre el -11: Mastercard bloquea los reintentos a partir del octavo intento rechazado dentro de 24 horas, identificando por código de comercio y número de tarjeta. Si un cliente insiste muchas veces, lo bloquea la marca, no tu tienda.

Errores de la API REST

Estos aparecen en los logs del plugin, no en la pantalla del comprador:

El 401 es el más frecuente al pasar de integración a producción: se cambian las credenciales de comercio pero se olvida el API Secret, o queda un espacio al copiar.

Límites de OneClick: -97, -98 y -99

Acá hay una confusión muy extendida, y conviene aclararla porque cambia a quién le reclamas:

No son límites del banco del comprador: son límites de tu código de comercio. Se resuelven con tu ejecutivo comercial de Transbank, verificando que la configuración esté alineada con lo que contrataste.

Relacionado: si al anular en OneClick recibes un Refund: 422 "Unknown" en ambiente de integración, la causa es un buyOrder repetido —varios integradores comparten el mismo código de comercio de prueba—. Se soluciona usando un buyOrder único de hasta 26 caracteres por transacción.

Errores de entorno

• SSL: certificado vigente y TLS 1.2 o superior. Sin HTTPS válido, el retorno desde Transbank falla.
• Timeouts: la sesión de Transbank expira a los pocos minutos. Revisa la URL de retorno y los tiempos de respuesta del servidor.
• El plugin rompe el sitio tras actualizar: pasó con varias versiones recientes según las reseñas del repositorio oficial. Actualiza en staging antes que en producción, y si el sitio queda caído, desactiva el plugin por FTP renombrando su carpeta.

Cómo diagnosticar cuando nada calza

1. Activa los logs del plugin y reproduce la compra fallida.
2. Ubica el responseCode o el código HTTP en el log; ese es el dato real, no el mensaje de pantalla.
3. Si el rechazo es genérico, pide el nivel 2 antes de seguir investigando.
4. Si el problema persiste, escribe a Transbank con el código de comercio, el buyOrder y el log completo de la transacción.

Tarjetas de prueba de WebPay

En el ambiente de integración se usan tarjetas de prueba, no tarjetas reales. Las credenciales del comercio de prueba y la tarjeta VISA están más arriba, en la configuración del ambiente de pruebas.

Dos detalles que hacen perder tiempo:

• El monto mínimo es $350 CLP. Por debajo de eso la transacción falla y el mensaje no dice por qué.
• Para probar un rechazo se usa una tarjeta distinta a la de aprobación. El listado vigente está en el portal de Transbank Developers; conviene revisarlo ahí porque cambia.

Prueba siempre los dos caminos, aprobado y rechazado, antes de certificar. La certificación exige evidencia de ambos.

Preguntas frecuentes

¿Qué significa el error 350 en WebPay?

Transbank no documenta ningún error 350 en Webpay Plus. Si lo ves durante una prueba, lo más probable es que se trate del monto mínimo de $350 CLP del ambiente de integración, no de un código de error. Busca el responseCode real en los logs del plugin.

¿Qué significa el error 21 en WebPay?

Tampoco está documentado por Transbank para Webpay Plus. Los códigos oficiales de rechazo van de -1 a -11, y los de la API REST son códigos HTTP. Si te aparece un 21, revisa dónde lo estás viendo: puede venir del banco emisor o de otro componente del checkout, no de WebPay.

¿Por qué todos mis rechazos dicen lo mismo?

Porque tu comercio está en nivel 1 de códigos de respuesta, que agrupa causas distintas bajo un mismo código. Pide el nivel 2 escribiendo a soporte@transbank.cl con tu código de comercio y pasarás a ver la causa concreta: tarjeta vencida, bloqueada, monto excedido.

¿Qué son los errores -97, -98 y -99?

Son límites de OneClick asociados a tu código de comercio, no del banco del comprador: cantidad de transacciones diarias (-99), monto máximo por transacción (-98) y monto acumulado diario (-97). Se ajustan con tu ejecutivo de Transbank.

¿Qué pasa si un cliente reintenta muchas veces?

A partir del octavo intento rechazado en 24 horas, Mastercard bloquea los reintentos identificando por código de comercio y número de tarjeta. Se refleja como código -11.

¿El plugin oficial puede romper mi sitio al actualizarse?

Ha ocurrido en varias versiones recientes según las reseñas del repositorio oficial de WordPress. Actualiza primero en un entorno de pruebas. Si el sitio ya quedó caído, desactiva el plugin renombrando su carpeta por FTP.

Buenas prácticas para maximizar conversiones

• Diseño mobile-first: la mayoría de compras online en Chile se realizan desde dispositivos móviles.
• Confianza y seguridad: muestra políticas de devolución claras y sello de sitio seguro.
• Recuperación de carritos: emails automáticos a 1h, 24h y 72h con descuentos progresivos.
• WhatsApp Business: útil para recuperación, dado que la gran mayoría de los chilenos lo usa a diario.

Casos de éxito y futuro del e-commerce en Chile

• Comercios que implementan WebPay Plus en WooCommerce reportan incrementos significativos en conversiones.
• En turismo, la mayor parte de los pagos se realizan con tarjeta de crédito.
• En retail, una proporción creciente de ventas online se realizan con tarjeta.
• El mercado seguirá expandiéndose, con proyecciones de crecimiento de dos dígitos anuales según estudios del sector.

Transbank ya trabaja en pagos con QR unificado, integración más fuerte con OnePay y funcionalidades cross-border para ventas internacionales. Quienes integren hoy estarán mejor preparados para adoptar estas mejoras.

Conclusión: tu próximo paso

Si vendes online en Chile, necesitas WebPay Plus en tu WooCommerce.

Con una inversión de tiempo de 1-2 semanas obtendrás:

• Acceso al método de pago más usado del país.
• Tasas de conversión más altas.
• Confianza inmediata de los clientes.

Inicia el proceso contactando a Transbank al 600 638 6380 o en publico.transbank.cl.

Complementa tu tienda con ERPSync

Si ya tienes WebPay Plus funcionando en tu WooCommerce, el siguiente paso para optimizar tu operación es sincronizar tu tienda con tu sistema de gestión. ERPSync conecta automáticamente WooCommerce con Softland ERP, manteniendo tu inventario, precios y pedidos actualizados en tiempo real. Una vez que tengas los pagos funcionando, el siguiente paso es la facturación electrónica. Completa tu stack de ecommerce con la integración de envíos Chilexpress.

¿Estás en otra plataforma? WebPay también se integra en Shopify y en Jumpseller, con el mismo convenio Transbank y distinto conector.

• Prepárate para los eventos de peak: CyberDay y Cyber Monday
• Conoce cómo funciona ERPSync
• Revisa nuestros planes desde 0.80 UF/mes
• ¿Tienes dudas? Consulta nuestras preguntas frecuentes o contáctanos