Implementando la API de Portupago: Pasos para Integrar la Pasarela de Pago en tu Sitio Web

Si eres un desarrollador que desea agregar la pasarela de pago de Portupago a tu sitio web, estás en el lugar correcto. En este artículo, te mostraremos los pasos para implementar la API de Portupago y comenzar a aceptar pagos de manera fácil y segura en tu plataforma.

Registro en Portupago

Antes de comenzar, debes registrarte en Portupago y obtener las credenciales necesarias para acceder a la API. Dirígete al sitio web de Portupago y sigue los pasos de registro. Una vez que hayas creado tu cuenta, recibirás una API Key que será necesaria para realizar las solicitudes a la API.

Obtención de la Documentación Técnica

Portupago proporciona una completa documentación técnica que te guiará en la integración de la API en tu sitio web. Accede a la documentación y familiarízate con los recursos disponibles, incluyendo los endpoints de la API, los parámetros requeridos y las respuestas esperadas.

Creación de una Orden de Pago

El primer paso para implementar la pasarela de pago de Portupago es la creación de una orden de pago. Para ello, debes realizar una solicitud GET a la API correspondiente, incluyendo los parámetros necesarios como el username, y la apykey, el monto del pago, la descripción de la compra, la url de redirección y cualquier otro dato relevante. La API te devolverá un identificador único de transacción (trx) que deberás almacenar para futuras referencias.

https://portupago.com/api/?apikey=TU_API_KEY&user=TU_USUARIO&amount=10.00&description=Compra%20de%20ejemplo&redir=https://example.com/verificarpago/?trx=&t=create

Debes reemplazar "TU_API_KEY" con tu API Key proporcionada por Portupago y "TU_USUARIO" con tu nombre de usuario en Portupago.

Los parámetros utilizados en la URL son los siguientes:

• apikey: Tu API Key de Portupago.
• user: Tu nombre de usuario en Portupago.
• amount: El monto de la compra. Debes asegurarte de utilizar un formato con dos decimales, por ejemplo, "10.00".
• description: La descripción de la compra. Puedes utilizar URL encoding para los espacios, por ejemplo, "Compra%20de%20ejemplo".
• redir: Url a la que será redireccionado el usuario cuando realice o cancele el pago.
• t: El tipo de solicitud, en este caso, "create" para crear una orden de compra.

Al llamar a esta URL, estarás creando una orden de compra en la API de Portupago y obtendrás una respuesta JSON con información sobre la transacción, incluyendo el ID de transacción (trx) y el monto.

Recuerda ajustar los parámetros según tus necesidades y utilizar esta URL dentro de tu código para realizar solicitudes a la API de Portupago.

Ejemplos:

function createTrx($user, $amount, $key, $description, $redir) {
    global $portupago;
	
    $url = $portupago . "/api/?apikey=".$key."&user=".$user."&amount=".$amount."&description=".$description."&redir=".$redir."&t=create";
    $json = file_get_contents($url);
    $data = json_decode($json, TRUE);
    return $data;
}
                

def create_trx(user, amount, key, description, redir):
    url = f"{portupago}/api/?apikey={key}&user={user}&amount={amount}&description={description}&redir={redir}&t=create"
    response = requests.get(url)
    data = response.json()
    return data
                

function createTrx(user, amount, key, description, redir) {
    const url = `${portupago}/api/?apikey=${key}&user=${user}&amount=${amount}&description=${description}&redir=${redir}&t=create`;
    fetch(url)
        .then(response => response.json())
        .then(data => {
            return data;
        });
}
                

Redirección al Pago

Una vez que has creado la orden de pago, es hora de redirigir al usuario a la página de pago de Portupago. Para ello, genera la URL de redirección agregando el valor del trx a la URL de pago de Portupago. Puedes utilizar la siguiente estructura: "https://portupago.com/pay/{trx}". El usuario será dirigido a la página de pago donde podrá completar la transacción de manera segura.

Verificación del Pago

Después de que el usuario haya completado el pago en Portupago, es importante verificar el estado de la transacción en tu sitio web. Puedes hacerlo utilizando la API de Portupago mediante una solicitud GET al endpoint correspondiente, proporcionando el trx como parámetro. La API te devolverá información detallada sobre el estado de la transacción, incluyendo si el pago se ha completado con éxito.

Para verificar el estado de una transacción en Portupago, puedes utilizar la siguiente URL:

https://portupago.com/api/?trx=ID_DE_TRANSACCION&t=get

En esta URL de ejemplo, debes reemplazar "ID_DE_TRANSACCION" con el ID de transacción que deseas verificar.

Al llamar a esta URL, estarás realizando una solicitud GET a la API de Portupago para obtener información sobre el estado de la transacción. La respuesta JSON que recibas incluirá detalles sobre la transacción, como su estado actual, el monto y otros datos relevantes.

Recuerda ajustar los parámetros según tus necesidades y utilizar esta URL dentro de tu código para verificar el estado de las transacciones en la API de Portupago.

Ejemplos:

function getTrx($trx) {
    global $portupago;
	
    $url = $portupago . "/api/?trx=".$trx."&t=get";
    $json = file_get_contents($url);
    $data = json_decode($json, TRUE);
    return $data;
}
                

def get_trx(trx):
    url = f"{portupago}/api/?trx={trx}&t=get"
    response = requests.get(url)
    data = response.json()
    return data
                

function getTrx(trx) {
    const url = `${portupago}/api/?trx=${trx}&t=get`;
    fetch(url)
        .then(response => response.json())
        .then(data => {
            return data;
        });
}
                

Manejo de Respuestas y Errores

Al interactuar con la API de Portupago, es esencial manejar adecuadamente las respuestas y los posibles errores. La API te devolverá respuestas en formato JSON, por lo que debes analizar las respuestas y tomar las acciones necesarias según el resultado. Si se produce un error, asegúrate de mostrar mensajes claros al usuario y tomar las medidas adecuadas para solucionar el problema.

Optimización y Mejoras

Una vez que hayas implementado la API de Portupago en tu sitio web, puedes explorar opciones adicionales para optimizar y mejorar la experiencia de pago. Esto puede incluir la personalización de la página de pago, la gestión de suscripciones, la generación de informes y mucho más. La documentación de la API de Portupago te brindará todas las opciones disponibles para ampliar y mejorar tu integración.

Conclusiones

La implementación de la API de Portupago en tu sitio web te permite ofrecer a tus clientes una forma segura y confiable de realizar pagos en línea en bolívares. Siguiendo los pasos mencionados anteriormente y utilizando la documentación proporcionada por Portupago, podrás integrar fácilmente la pasarela de pago en tu plataforma y brindar una experiencia de compra fluida y segura.