HomeGuidesAPI Reference
Guides
Start typing to search…

OnePay

OnePay es una pasarela de pago disponible para Colombia, que permite a tus clientes pagar facturas de Wispro a través de un flujo guiado por WhatsApp y, si usan la app Alerta Internet, también desde la opción Pagar dentro de la factura.

Requisito previos

Antes de configurar OnePay en Wispro, el ISP debe contar con lo siguiente:

  • Cuenta activa en OnePay (registro y habilitación del comercio).
  • App Key privada generada en el portal de OnePay.
  • Webhook creado en OnePay apuntando a Wispro, para notificar pagos.
  • En cada cliente que vaya a pagar con OnePay, deben estar cargados estos datos obligatorios:
    • Número de celular (WhatsApp)
    • Número de cédula
    • Email
🚧

Importante

El celular y el email deben ser válidos y estar correctamente cargados en el cliente, ya que OnePay envía la factura por WhatsApp y el comprobante por email.

Configuración en OnePay

Configurar App Keys

  1. Ingresá al panel de OnePay OnePay

  2. ingresá al menú Developers → App Keys

  3. Hacé clic en Crear AppKey.

  4. Completá los campos:

    • Name: por ejemplo, Integración Wispro
    • Tipo de AppKey: seleccioná Privada

  5. Confirmá con Enviar.

  6. Copiá la AppKey generada y guardala, ya que es la que vas a ingresar en Wispro al momento de crear la pasarela OnePay.

Configurar webhook

El webhook es necesario para que OnePay notifique a Wispro cuando una factura fue pagada y el sistema pueda registrar el pago automáticamente.

  1. En OnePay, ingresá a Developers → Webhooks

  2. Hacé clic en Crear Webhook.

  3. Configurá los campos:

  4. Confirmá con Enviar.

📘

Importante

  • La URL debe estar copiada exactamente igual, ya que cualquier diferencia puede impedir que Wispro reciba el evento.

Crear la pasarela OnePay en Wispro

  1. Ingresá a Facturación → Parámetros → Pasarelas de pago.
  2. Hacé clic en Crear nueva pasarela de pago.
  3. Seleccioná OnePay.
  4. Completá:
    • Nombre de la pasarela
    • Api Key: pegá la** AppKey** obtenida desde OnePay.
  1. Clic en Crear para finalizar el proceso.

Una vez creada la pasarela de pago se podrá observar en el listado de pasarelas activas.

Asociar OnePay a tus clientes

Para que OnePay funcione correctamente, es obligatorio que cada cliente tenga cargados:

  • Celular: OnePay envía la factura por WhatsApp
  • Número de cédula
  • Correo electrónico: OnePay envía el comprobante por email

Luego de crear la pasarela, es necesario asignarla a los clientes que van a pagar con OnePay.

Ingresar a:

Clientes > Búsqueda avanzada > Actualización masiva

En el apartado Pasarelas de pago:

  • Seleccionar OnePay
  • Hacer clic en Agregar
  • Seleccionar los clientes a actualizar
  • Finalizar con Actualizar masivamente

Cómo funciona el pago

Flujo general

  1. Se genera una factura en Wispro.
  2. Esa factura queda disponible para gestionarse mediante OnePay.
  3. El cliente recibe la factura y realiza el pago.
  4. OnePay notifica el pago a Wispro y el sistema intenta registrarlo automáticamente.

Pago por WhatsApp

  • El cliente recibe por WhatsApp:
    • La factura en PDF
    • Un botón o enlace para Iniciar pago
  • El cliente selecciona el método de pago (tarjeta o transferencia, según lo disponible).
  • Finalizado el proceso, OnePay muestra el estado de la transacción y emite el comprobante.
📘

Si el pago no ingresa automáticamente

Si un pago no se refleja en Wispro, se puede:

  • Buscar la transacción para identificar el pago.
  • Verificar el estado desde OnePay.
  • Realizar la acción correspondiente para que el pago quede aplicado.

Pago desde la app "Alerta Internet"

Si el cliente utiliza la app Alerta Internet, puede ver sus facturas pagadas e impagas y, si corresponde, pagarlas desde la misma aplicación utilizando la pasarela OnePay.

📘

Requisitos

  • El cliente debe tener instalada y activa la app Alerta Internet.
  • El cliente debe tener asociada la pasarela de pago OnePay para que aparezca como opción de pago al momento de abonar.
  • La factura debe encontrarse en estado Impaga.

Paso a paso

  1. En la app Alerta Internet, seleccionar la factura que se desea pagar.

    • La factura se mostrará con el estado o etiqueta Impaga.

  2. Presionar el botón Pagar.
  3. La app mostrará una pantalla con el monto a pagar y solicitará seleccionar un medio de pago.

    • Es posible que aparezca más de un medio de pago si el cliente tiene varias pasarelas asociadas.

  4. Seleccionar OnePay como medio de pago.
  5. La app redirigirá a una pantalla de OnePay para completar el pago.
  6. En OnePay, el cliente deberá completar los datos solicitados para finalizar la transacción.

    • Por ejemplo, OnePay puede solicitar el número de WhatsApp y los datos del medio de pago para completar el proceso.

🚧

Consideraciones

  • Si OnePay no aparece como opción, normalmente se debe a que el cliente no tiene la pasarela asociada o no está habilitada para ese cliente.
  • Una vez finalizado el pago en OnePay, el proceso continúa según el flujo habitual de confirmación de la pasarela.

Confirmación del pago en Wispro

Una vez aprobado el pago:

  • OnePay envía el comprobante al email del cliente.
  • Wispro debería recibir el pago automáticamente mediante el webhook.

Si el pago no impacta automáticamente, se puede:

  • Buscar la transacción del pago desde Wispro, utilizando el identificador de transacción que provea OnePay. Para ello se debe rastrear el "Id de origen" de la factura.

Buscar transacción en OnePay (cuando el pago no ingresa automáticamente)

1 - Obtener el identificador de la transacción en OnePay

Para poder buscar la transacción en Wispro, primero necesitás el código Id de origen o Referencia única. Este identificador se encuentra en el comprobante de OnePay y también puede obtenerse desde el panel de administración de OnePay.

Opción A: Desde el comprobante de OnePay

  • En el comprobante de pago, buscá el campo Id de origen.
    Es un código similar a: 019c0b20-b506-71a6-94sd-7718c09b34e4

Opción B: Desde el portal de OnePay

  1. Ingresá a OnePay desde: https://admin.onepay.la/

  2. Iniciá sesión con tu cuenta.

  3. En el menú, ingresá a Cobros.

  4. Buscá el pago correspondiente (por ejemplo, puede figurar como Pendiente).

  5. Hacé clic sobre el cobro para ver el detalle.

  6. Copiá el valor de Referencia única .

2 - Buscar la transacción desde Wispro

Con la Referencia única copiada, ingresá a Wispro y realizá la búsqueda desde la pasarela.

  1. Ingresá a Facturación > Parámetros > Pasarelas de pago.

  2. Localizá la pasarela OnePay.

  3. Hacé clic en el ícono de lupa (buscar transacción).

  4. Se abrirá un modal de búsqueda.

  5. Pegá el Id de origen / Referencia única obtenido desde OnePay.

  6. Hacé clic en Buscar.

  7. Wispro mostrará los detalles del pago (estado, fecha, monto y método de pago).

  8. Hacé clic en Procesar transacción en Wispro.

Resultado esperado

  • Se creará el pago correspondiente dentro de Wispro.
  • La factura quedará saldada (pagada) si el monto cubre el total.

Recomendaciones y buenas prácticas

  • Evitá cambiar credenciales o parámetros en OnePay sin revisar la integración.
  • Asegurate de que cada cliente tenga celular, cédula y email completos antes de intentar cobrar con OnePay.
  • Verificá que el webhook esté activo y con el evento Factura pagada seleccionado.

Updated about 6 hours ago