Módulo Paygol para BoxBilling, versión 1.2

 

Requerimientos

  • Instalación funcional de BoxBilling (probado hasta la versión 4.20).
  • Cuenta en Paygol, puede registrarse de forma gratuita en https://secure.paygol.com/signup

 

Instalación

  • Descargue el módulo BoxBilling.
  • Descomprima el archivo paygol-for-boxbilling_1.2.zip directamente en su carpeta base de BoxBilling.
  • Instale el módulo de Paygol en su panel de administración de BoxBilling (Configuration -> Payment Gateways -> New payment gateway), seleccione “Paygol” y presione “Install“.
  • Una vez instalado, configure el módulo (Configuration -> Payment Gateways), seleccione “Paygol” y presione sobre el icono de editar (Icono del lápiz).
  • Inicie sesión en su panel de control de Paygol y vaya a la sección “Notificaciones”, copie el ID de Servicio y el Secret Key desde tu cuenta y peguelos en los campos con los mismos nombres en la configuración del modulo Paygol de su sitio BoxBilling.
  • Copie el campo “IPN Callback URL” desde su configuración del módulo Paygol y péguela en el campo “URL de IPN” en la sección “Notificaciones” de su panel de control Paygol y luego guarde los cambios.
  • Asegúrese que los siguientes parámetros están configurado de esta manera en su módulo Paygol:
    • “Enabled: Yes“.
    • “Allow one time payments: Yes“.
    • “Enable test mode: No
  • Presione “UPDATE” en su sitio BoxBilling, para guardar la configuración.

 

Pruebas

Para probar el módulo tras su instalación, puede activar el modo de pruebas de su servicio con el boton “Live/Test” en la esquina superior derecha de su panel de control en el sitio web de Paygol. Recuerde cambiarlo de vuelta una vez concluidas las pruebas.

 

Imagen del botón de pago

Para asegurarle de que todas las instancias del botón de pago de Paygol se visualizarán correctamente, por favor siga las siguientes instrucciones:

  • Edite el archivo “logos.css” de su instalación de BoxBilling. Este archivo se encuentra en “bb-themes/huraga/assets/css/logos.css“.
  • Agregue las siguientes lineas de código al final del archivo “logos.css” y guarde los cambios.:
    .logo-PayGol{
         background: transparent url("../img/gateway_logos/PayGol.png") no-repeat scroll 0% 0%;
         background-size: contain;
         width:80px;
         height: 28px;
         border: 0;
         margin: 10px;
    }
    

Favor de considerar:

En el caso de no utilizar la plantilla por defecto “huraga“, es necesario hacer lo siguiente:

  • Modificar el archivo CSS en la carpeta correcta, no en “huraga“. Ejemplo: “bb-themes/elThemeQueEstoyUtilizando/assets/css/logos.css“.
  • Copiar la imagen “bb-themes/huraga/assets/img/gateway_logos/Paygol.png” a una ruta similar correspondiente a la otra plantilla. Ejemplo:
    bb-themes/elThemeQueEstoyUtilizando/assets/img/gateway_logos/Paygol.png“.
  • Como método alternativo a los puntos anteriores, simplemente cambie el nombre del directorio “huraga” al nombre del directorio que utilizará, este cambio debe aplicarlo antes de copiar el módulo Paygol a su servidor web.

 

Notas importantes

  • En modo de pruebas se realizará un llamado IPN (notificación de pago a su plataforma) inmediatamente después de cada prueba.
  • Una vez que un pago sea completado, el mismo se mostrará como completado, pero pendiente de instalación (Pending Setup) hasta que usted lo active en su panel de BoxBilling.
  • Los pagos usualmente son notificados de forma inmediata; ahora bien, algunos métodos de pago podrían tomar más tiempo en notificar la transacción (ej: métodos que toman algunos minutos en realizar la notificación, o métodos basados en boletos que deben ser impresos y pagados en efectivo). Recomendamos que informe a su clientela sobre esto a modo de evitar confusiones.