Bancolombia

Requisitos previos

Antes de crear la pasarela en Wispro, el ISP debe contar con una cuenta y gestión habilitada con Bancolombia y tener disponibles estos datos:

  • Nombre de la pasarela (por ejemplo: Bancolombia Recaudo).
  • Número de convenio (provisto por Bancolombia).
  • NIT (del ISP).
  • Webservice:
    • Usuario
    • Contraseña
📌

Importante

Estos datos se coordinan con un ejecutivo de Bancolombia. Durante esa gestión, el banco también solicitará la documentación de endpoints de Wispro para poder informar los pagos a la plataforma.


1- Crear la pasarela de pago en Wispro

  1. Ingresar a Facturación > Parámetros > Pasarelas de pago.
  2. Seleccionar Crear nueva pasarela de pago.
  3. Elegir Bancolombia.
  4. Completar los campos solicitados:
  • Nombre
  • Número de convenio
  • NIT
  • Usuario (Webservice)
  • Contraseña (Webservice)
  1. Finalizar con Crear.

2- Verificar la pasarela

Una vez creada, se recomienda confirmar que la pasarela quedó operativa.

  • Si en el listado aparece la opción Verificar pasarela (ícono de rayo), utilizarla para validar la configuración.
  • Si no se visualiza esa opción, la pasarela queda lista una vez guardados correctamente los datos.

3- Requisito en el cliente

Para operar correctamente, cada cliente debe tener cargado su Documento/Cédula (o identificación equivalente).
Si falta, es necesario completarlo antes de utilizar la pasarela.

4- Coordinación con Bancolombia (endpoints y activación)

Para que Bancolombia pueda informar pagos a Wispro, es necesario coordinar con un ejecutivo del banco y presentar:

  • Número de convenio
  • NIT
  • Usuario y contraseña del Webservice
  • Documentación de endpoints de Wispro (para la notificación de pagos)

Qué es la documentación de endpoints

Es el documento donde se detalla:

  • La URL o endpoint al que Bancolombia debe enviar la notificación.
  • Qué datos debe incluir (por ejemplo: referencia, monto, fecha, estado).
  • Cómo se realiza la autenticación del envío (según el esquema definido).

5- ¿Cómo funciona el cobro?

El flujo general es:

  1. Wispro genera las facturas del cliente de forma habitual.
  2. El cliente paga mediante Bancolombia, bajo el convenio configurado.
  3. Bancolombia informa la transacción a Wispro (a través del webservice/endpoints definidos).
  4. Wispro registra el pago y la factura queda actualizada según corresponda (pagada o parcialmente pagada).