📑 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://siivvtelco.pagoralia.com/api/linkmikro

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://siivvtelco.pagoralia.com/api/linkmikro?token=TOKEN&cliente=000021

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

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

try {
  const response = await axios.get(URL_PAGORALIA, { timeout: 25000 })
  const data = response?.data ?? ''
  user.pagoralia_url = data?.redirect ?? '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:

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.redirect antes de usar el link.

  • El subdominio o nombre del merchant puede ser diferente a como está cargado en Suricata.

  • Solicitar a comercial de Pagoralia la verificación de la información cargada en su respectivo cloud. Tiene que verificar se encuentre cargados los datos siguientes: url, apikey, slug.

  • 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.

PreviousGet Data MikrowispNextPhantom

Last updated