Integración de pagos PSE y Nequi en tu aplicación web en Colombia

El ecosistema de pagos digitales en Colombia

Colombia tiene uno de los ecosistemas de pagos digitales más desarrollados de Latinoamérica. PSE (Pagos Seguros en Línea) es el estándar de débito bancario; Nequi y Daviplata son billeteras digitales con millones de usuarios; y las tarjetas débito/crédito dominan el e-commerce. Si tienes una aplicación web o tienda online en Colombia, necesitas ofrecer al menos PSE y tarjetas para no perder ventas.

En MatuByte hemos integrado múltiples pasarelas de pago en plataformas SaaS, e-commerce y software de gestión. Esta guía comparte lo que hemos aprendido.

Las principales pasarelas de pago en Colombia

Wompi (Bancolombia)

Wompi es la pasarela de Bancolombia, el banco más grande de Colombia. Soporta:

• Tarjetas Visa, Mastercard y American Express.
• PSE (débito bancario directo).
• Nequi.
• Efectivo (Efecty, Baloto).
• Transferencias Bancolombia (solo app Bancolombia).

Wompi tiene una API REST bien documentada, un sandbox gratuito para pruebas y una integración relativamente sencilla. Es nuestra recomendación #1 para la mayoría de e-commerce y SaaS en Colombia.

PayU

PayU es una de las pasarelas más antiguas y con mayor cobertura en Colombia y LATAM. Soporta múltiples métodos de pago y tiene presencia en México, Argentina, Chile, Perú y otros países — ideal si tu negocio opera en múltiples países latinoamericanos.

Epayco

Epayco es colombiana, con buena documentación y soporte local. Soporta PSE, tarjetas, Nequi y efectivo. Popular entre pymes y emprendedores colombianos.

Bold

Bold es una fintech colombiana enfocada en datáfonos móviles y pagos en persona, pero también tiene solución para e-commerce. Muy popular entre pequeños negocios.

¿Cómo funciona el flujo de pago con PSE?

PSE es el método de pago más importante para transferencias bancarias en Colombia. El flujo es:

1. El usuario elige "Pagar con PSE" en tu tienda.
2. Tu backend llama a la API de la pasarela (Wompi, PayU, etc.) creando una transacción.
3. La pasarela redirige al usuario al portal PSE de ACH Colombia.
4. El usuario elige su banco, ingresa sus credenciales bancarias y autoriza el pago.
5. ACH Colombia notifica a la pasarela el resultado del pago.
6. La pasarela notifica a tu backend via webhook (URL que tu sistema debe exponer).
7. Tu sistema actualiza el estado del pedido y notifica al usuario.

El proceso completo tarda entre 1 y 3 minutos para transacciones exitosas.

Integrar Nequi en tu aplicación

Nequi tiene dos tipos de integración:

• Cobro Push (recomendado): Tu aplicación llama a la API de Nequi indicando el número de celular del cliente y el monto. El cliente recibe una notificación en su app Nequi y acepta el pago con un clic. Sin redirecciones, experiencia fluida.
• Vía Wompi: Si ya usas Wompi, el pago con Nequi está disponible automáticamente como método de pago sin integración adicional.

Ejemplo práctico: Integrar Wompi en Next.js

Wompi funciona principalmente con un widget JavaScript que se puede integrar en cualquier frontend. Aquí el ejemplo básico:

// Backend: crear transacción en Wompi
const response = await fetch('https://production.wompi.co/v1/transactions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_prod_TU_LLAVE_PRIVADA',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    amount_in_cents: 5000000, // $50.000 COP en centavos
    currency: 'COP',
    customer_email: 'cliente@empresa.com',
    payment_method: {
      type: 'PSE',
      user_type: 0, // 0 = persona natural, 1 = empresa
      user_legal_id_type: 'CC',
      user_legal_id: '123456789',
      financial_institution_code: '1022', // Código del banco
      payment_description: 'Pedido #1234',
    },
    redirect_url: 'https://tusitioweb.com/pago/resultado',
    reference: 'PEDIDO-1234',
  }),
});

const { data } = await response.json();
// Redirigir al usuario a data.payment_method.extra.async_payment_url

Requisitos para aceptar pagos en línea en Colombia

Para integrarte con pasarelas de pago colombianas necesitas:

• RUT actualizado: Con actividad económica de comercio electrónico si aplica.
• Cuenta bancaria empresarial: Donde se depositarán tus ventas.
• Proceso de KYC (Know Your Customer): Las pasarelas verifican tu identidad y la de tu empresa.
• Política de devoluciones y privacidad: Algunos proveedores las requieren publicadas en tu sitio.
• SSL/HTTPS: Tu sitio debe tener certificado SSL activo (HTTPS).

El proceso de aprobación varía: Wompi puede tomar 1-3 días hábiles; PayU puede demorar más si requiere más documentación.

Costos de las pasarelas colombianas (2025)

• Wompi: 2.9% + $900 COP por transacción con tarjeta. PSE: 1.5% + comisión fija. Sin costo mensual.
• PayU: Comisión variable por método de pago y volumen. Consultar según tu caso.
• Epayco: 2.90% + IVA por tarjeta. PSE: comisión similar. Sin mensualidad.

MatuByte integra pasarelas de pago en tu aplicación

En MatuByte S.A.S desarrollamos e integramos pasarelas de pago colombianas en aplicaciones web, e-commerce y plataformas SaaS. Si necesitas que tu aplicación acepte PSE, Nequi, tarjetas u otros métodos de pago, podemos implementarlo correctamente y con el manejo de errores y webhooks necesario para producción.

Escríbenos a contacto@matubyte.com para una cotización de integración de pagos para tu proyecto.