Resolviendo Problemas para Integrar PSE y Tarjetas Locales en Mi Web: Una Guía Completa

Problemas para integrar PSE y tarjetas locales en mi web: por qué falla y cómo solucionarlo

Si intentas vender en Colombia, el botón de PSE no es una opción: es requisito. Según datos de ACH Colombia, PSE procesó más de 600 millones de transacciones solo en los primeros ocho meses de 2026, con un crecimiento del 14% frente a 2025. Durante el Hot Sale de marzo, se moviliaron más de 31 billones de pesos en apenas cinco días. Si tu e-commerce no acepta PSE o tarjetas locales como Nequi, Daviplata o Pago Contrareembolso, estás dejando fuera a la mayoría de compradores colombianos.

Pero integrar estos métodos de pago en WordPress no siempre es sencillo. Errores de configuración, plugins incompatibles y problemas de seguridad SSL son la norma, no la excepción. En este artículo te explico los fallos más frecuentes al integrar PSE, Wompi, PayU y Mercado Pago en tu tienda, con pasos concretos para resolverlos.

¿Por qué PSE falla al integrarlo en WordPress?

PSE (Pagos Seguros en Línea) funciona como puente entre tu tienda y el banco del cliente. El usuario selecciona su entidad bancaria, autoriza el débito y tú recibes la confirmación. El problema aparece cuando la configuración técnica no está bien hecha.

1. Credenciales de API mal configuradas

La causa más frecuente de fallos es la configuración incorrecta de las credenciales de API del proveedor de pagos. Cada pasarela (Wompi, PayU, Placetopay) genera un par de claves: una pública (client key) y otra secreta (secret key). Si la secreta está en el campo equivocado, si tiene espacios al inicio o al final, o si estás usando las credenciales de sandbox en producción (o viceversa), la transacción no se procesará.

Solución: verifica en el panel de tu proveedor de pagos que las credenciales coincidan exactamente con las que ingresaste en WordPress. Usa el modo sandbox para hacer al menos tres pruebas antes de activar producción. Si usas Wompi, recuerda que sus credenciales de prueba son distintas para tarjeta, PSE y Nequi.

2. Certificado SSL ausente o mal configurado

Ninguna pasarela de pagos aceptará transacciones desde un sitio sin HTTPS válido. Y no basta con tenerlo instalado: según datos de SSL Labs, el 29% de los sitios web principales todavía tienen configuración SSL inadecuada, lo que puede causar errores de «mezcla de contenido» (mixed content) que rompen el proceso de pago.

Solución: instala un certificado SSL gratuito de Let’s Encrypt (la mayoría de hosts lo ofrecen con un clic) y verifica que todas las URLs internas de tu tienda apunten a https://. Herramientas como SSL Labs te dan una calificación de A a F de tu configuración.

3. Plugin incompatibles o en conflicto

WordPress tiene cientos de plugins de pago, y no todos conviven bien entre sí. Un plugin de caché agresivo puede interferir con las llamadas API de pago. Un plugin de seguridad puede bloquear las notificaciones webhook que el proveedor envía para confirmar la transacción. Y algunos plugins de pago abandonados no se actualizan con las nuevas versiones de WooCommerce.

Solución: mantén el plugin de pago actualizado y desactiva temporalmente los plugins de caché durante las pruebas de integración. Si usas WooCommerce, revisa la compatibilidad del plugin de pago con tu versión actual en la pestaña de compatibilidad del repositorio oficial.

Wompi: la opción que crece más rápido en Colombia

Wompi, la plataforma de pagos de Grupo Cibest (Bancolombia), cerró 2025 con 50 billones de pesos procesados, un crecimiento del 130% frente a 2024. Procesó más de 160 millones de transacciones y cuenta con más de 40.000 comercios activos mensuales. Es, junto con PSE, la infraestructura de pago digital de mayor crecimiento en el país.

Integrar Wompi en WordPress es relativamente sencillo: su plugin oficial (Wompi para WooCommerce) se configura en minutos. Los errores más comunes al integrarlo son:

• No activar el modo sandbox antes de probar. Si saltas directo a producción, los errores de configuración se traducen en transacciones reales fallidas.
• Olvidar configurar el webhook. Wompi notifica el estado del pago a tu sitio vía webhook. Si tu servidor bloquea esas llamadas (por un firewall mal configurado), la orden se queda en «pendiente» aunque el cliente ya pagó.
• No configurar los medios de pago. Wompi soporta tarjeta, PSE, Nequi, Daviplata y más, pero cada medio se activa por separado. Si solo activas tarjeta, pierdes a los clientes que prefieren PSE o Nequi.

PayU: errores comunes en la integración

PayU es otra de las pasarelas más usadas en Latinoamérica. Su integración con WordPress sigue un patrón similar, pero con particularidades:

• Cuenta de pruebas vs. producción: PayU utiliza diferentes API URLs para sandbox y producción. Usar la URL de sandbox en producción genera errores 401 o transacciones que nunca se confirman.
• Signature de seguridad: PayU valida la firma de cada transacción con un algoritmo MD5 o SHA256. Si tu plugin genera la firma con un algoritmo distinto al configurado en tu cuenta PayU, todas las transacciones serán rechazadas.
• Moneda y país: PayU maneja diferentes monedas por país. Si configuras COP (pesos colombianos) pero tu cuenta PayU está registrada en México, el pagador recibirá un error de moneda no soportada.

Mercado Pago: lo que debes saber antes de integrar

Mercado Pago es la pasarela dominante en Argentina, Brasil, México y Chile. Su plugin oficial para WooCommerce es gratuito y bastante estable. Los problemas más frecuentes no son técnicos, sino de configuración:

• Webhooks duplicados: si configuras el webhook tanto en el panel de Mercado Pago como en el plugin de WordPress, recibirás doble notificación, lo que puede provocar duplicación de estados de pedido.
• Checkout vs. Plugin: Mercado Pago ofrece dos métodos de integración: el checkout redirige al sitio de Mercado Pago, mientras que el plugin embebe el formulario en tu tienda. El checkout es más fácil de configurar; el plugin requiere un certificado SSL válido y compatibilidad con la API v2.
• Cuotas (pagos diferidos): en Argentina, Mercado Pago permite el pago en cuotas. Si no configuras correctamente las cuotas en el plugin, el cliente verá opciones de financiación que tu negocio no acepta realmente.

Checklist: 7 pasos para evitar problemas de integración de pago

Antes de activar cualquier método de pago en producción, verifica esto:

1. SSL activo y válido: tu sitio carga correctamente con https:// y no hay mezcla de contenido.
2. Credenciales correctas: client key y secret key del modo que vas a usar (sandbox o producción).
3. Webhook configurado: la URL de notificación apunta a tu sitio y el servidor la acepta sin bloquear.
4. Modo sandbox activo: haz al menos 3 transacciones de prueba con diferentes medios de pago.
5. Plugins de caché desactivados durante las pruebas de integración.
6. Medios de pago habilitados: activa todos los que tu negocio soporta (PSE, Nequi, tarjeta, etc.).
7. Moneda y país configurados: la moneda del plugin coincide con la de tu cuenta en el proveedor.

Preguntas frecuentes

Integrar métodos de pago locales no tiene por qué ser un dolor de cabeza. La clave está en probar cada configuración en sandbox antes de producción, verificar tus credenciales y no dejar de lado la seguridad SSL. Si tu carrito de compras está fallando o tus clientes reportan errores al pagar, empieza por revisar estos puntos: en la mayoría de los casos, el problema se resuelve en menos de una hora.

Si tu e-commerce también sufre problemas de carrito abandonado o errores en formularios de contacto, revisa nuestros artículos sobre por qué se caen las compras en WooCommerce y cómo evitar errores en formularios de contacto.