📑 Documentación: Obtención de link de pago en Pagoralia

Verificar que el merchant se encuentre con toda la información cargada en la plataforma de Pagoralia, en todo caso contactar con comercial o soporte de Pagoralia.

Este proceso permite generar un link de pago para un cliente a través de la API de Pagoralia. El link se obtiene haciendo una solicitud GET a la URL del servicio, pasando como parámetros el token de autenticación y el idcustomer del cliente.

GET https://redytel.pagoralia.com/api/linkwisphub

Parámetros requeridos (query string):

• token → Token de autenticación de la API.

• cliente → ID del cliente en el sistema.

Ejemplo de URL construida: https://redytel.pagoralia.com/api/linkwisphub?token=MI_TOKEN&cliente=12345

Ejemplo en código (JavaScript / Node.js con Axios)

user.topic_id = 303 //Setear topic
const URL_PAGORALIA = `https://${env.merchant}.pagoralia.com/api/linkwisphub?token=${env.sienna_token}&cliente=${user.idcustomer}`

try {
  const response = await axios.get(URL_PAGORALIA)
  const data = response?.data ?? ''
  user.pagoralia_url = data?.url ?? 'Sin Url'

  // Si no se pudo obtener el link, se cambia el flujo de conversación
  if (user.pagoralia_url === 'Sin Url') {
    user.topic_id = 304 // Topic en caso de no encontrar URL
  }
} catch (err) {
  console.error({ ErrToGetUserPay: err.message })
  user.topic_id = 304 // Topic en caso de no encontrar URL
}

4. Respuesta esperada de la API

La API retorna un objeto JSON con la URL del link de pago. Ejemplo:

{
  "url": "https://pagoralia.com/pago/123456789"
}

Si no se encuentra el link o ocurre un error, la propiedad url puede venir vacía o no estar presente.

5. Manejo de errores

• Si la API no devuelve una url, se asigna el valor "Sin Url".

• En ese caso, el flujo cambia el topic_id a 304 para indicar que no se pudo generar el link de pago.

• Se registra el error en consola para diagnóstico.

6. Notas

• Es importante validar siempre la existencia de data.url antes de usar el link.

• El token debe mantenerse seguro, no debe exponerse en frontend.

• El endpoint puede fallar si:

  • El token no es válido.

  • El cliente no existe en el sistema.

  • Hay un problema en los servidores de Pagoralia/Wisphub.