Integración de la Pasarela de Pagos Wompi con PrestaShop: Módulo de Conexión y Desarrollo Personalizado por API

En Colombia, Wompi, una pasarela de pagos respaldada por Bancolombia, se ha consolidado como una solución confiable y versátil para procesar transacciones en línea. Su integración con PrestaShop, una de las plataformas de e-commerce más populares, permite a los comerciantes ofrecer múltiples métodos de pago adaptados al mercado local. Este artículo explora en detalle cómo integrar Wompi con PrestaShop, con un enfoque en el módulo de conexión Wompi y el desarrollo personalizado utilizando su API, proporcionando una guía completa para comerciantes y desarrolladores.

🎯 ¿Qué es Wompi y por qué usarlo en PrestaShop?

Wompi es una pasarela de pagos digitales que permite a las empresas aceptar transacciones mediante:

1. Tarjetas de crédito y débito (Visa, MasterCard, Amex, etc.)
2. Transferencias bancarias (PSE en Colombia)
3. Pagos en efectivo (Efecty, Baloto, etc.)
4. Billeteras digitales y métodos alternativos

Ventajas de Wompi 

✅ Alta seguridad: Cumple con estándares PCI DSS para protección de datos.
✅ Multiplataforma: Funciona en web, móvil y puntos físicos.
✅ Procesamiento rápido: Transacciones en tiempo real.
✅ Disponibilidad regional: Ideal para mercados como Colombia y otros países latinoamericanos.

Integrar Wompi con PrestaShop permite a las tiendas online ofrecer una experiencia de pago localizada y sin fricciones, aumentando las tasas de conversión.

🏧 Integración Básica: Módulo Oficial de Wompi para PrestaShop

Wompi ofrece un módulo oficial para PrestaShop que simplifica la configuración.

Pasos para instalar el módulo

1. Descargar el módulo: Disponible en el sitio oficial de Wompi o en el marketplace de PrestaShop.

2. Subirlo a PrestaShop:

   • Ir a Módulos > Añadir nuevo módulo y cargar el archivo ZIP.

3. Configurar credenciales:

   • Ingresar el API Key pública y privada (disponibles en el dashboard de Wompi).

   • Seleccionar métodos de pago habilitados (tarjetas, PSE, etc.).

4. Probar en modo sandbox:

   • Activar el modo de pruebas para verificar que las transacciones funcionen correctamente.

Limitaciones del módulo estándar

Aunque el módulo oficial es útil, puede tener limitaciones en:

• Personalización del flujo de pago

• Soporte para funcionalidades avanzadas (pagos recurrentes, divisas alternativas, etc.)

• Adaptación a diseños customizados

Por ello, muchas empresas optan por un desarrollo personalizado mediante API.

Desarrollo Personalizado: Integración de Wompi con PrestaShop vía API

Para una solución más flexible, se puede desarrollar un conector personalizado utilizando la API de Wompi.

Flujo de integración con la API de Wompi

1. Crear un evento de pago (/v1/transactions):

   • PrestaShop envía los datos de la orden (monto, referencia, cliente).

   • Wompi genera un link de pago o un formulario embebido.

2. Redirección o pago embebido:

   • El cliente es dirigido a Wompi o ve el formulario dentro de la tienda.

3. Confirmación y webhooks:

   • Wompi notifica a PrestaShop vía webhook cuando el pago es exitoso.

   • PrestaShop actualiza el estado del pedido automáticamente.

Ejemplo de código para conexión API (PHP)

// Configurar credenciales
$publicKey = "pub_test_xxxxxxxx";
$privateKey = "prv_test_xxxxxxxx";

// Datos de la transacción
$transactionData = [
    "amount_in_cents" => 1000000, // $1.000.000 COP
    "currency" => "COP",
    "customer_email" => "cliente@example.com",
    "reference" => "ORD12345",
    "payment_method" => [
        "type" => "CARD",
        "token" => "tok_test_xxxxxx"
    ]
];

// Enviar solicitud a Wompi
$ch = curl_init("https://sandbox.wompi.co/v1/transactions");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $privateKey,
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($transactionData));

$response = curl_exec($ch);
curl_close($ch);

// Procesar respuesta
$data = json_decode($response, true);
if ($data['data']['status'] == "APPROVED") {
    // Actualizar pedido en PrestaShop como "Pagado"
}

Ventajas de una Integración Personalizada - Desarrollo API Wompi

🔹 Mayor control sobre el proceso de pago (personalización de UI/UX).
🔹 Soporte para funcionalidades avanzadas (suscripciones, pagos parciales).
🔹 Mejor manejo de errores y logs para diagnóstico de problemas.
🔹 Optimización para SEO y rendimiento (evitar redirecciones innecesarias).

La integración de Wompi con PrestaShop es una solución poderosa para comercios electrónicos en Latinoamérica. Mientras el módulo oficial es una opción rápida, un desarrollo personalizado por API ofrece mayor flexibilidad y control.

Si necesitas una implementación avanzada, es recomendable trabajar con desarrolladores expertos en PrestaShop y APIs de pagos para garantizar una integración segura y eficiente.

¿Listo para integrar Wompi en tu tienda PrestaShop? ¡Empieza hoy con Nosotros y mejora la experiencia de pago de tus clientes! 🚀

Desafíos y Consideraciones

Conocimientos técnicos: El desarrollo personalizado requiere experiencia en PHP, APIs RESTful y el ecosistema de PrestaShop.

Seguridad: Asegúrate de cumplir con los estándares PCI DSS y evitar almacenar datos sensibles de tarjetas en tu servidor.

Mantenimiento: Las integraciones personalizadas requieren actualizaciones periódicas para mantener la compatibilidad con nuevas versiones de PrestaShop y Wompi.

Soporte limitado: A diferencia del módulo oficial, las integraciones personalizadas no cuentan con soporte técnico de Wompi, por lo que dependerás de tu equipo de desarrollo.