BoxBilling


Módulo de Paygol v1.1 para BoxBilling

 

Requerimientos

  • Instalación funcional de BoxBilling (probado con versión 4.20).
  • Cuenta en Paygol.

Instalación

  • Descarga módulo BoxBilling
  • Descomprime el archivo paygol_for_boxbilling_1.1.zip directamente en tu carpeta de BoxBilling.
  • Para instalar el módulo, ve al panel de administración de BoxBilling (Configuration -> Payment Gateways), selecciona Paygol en la pestaña “New payment gateways”, y haz click en “Install”.
  • Una vez instalado, procede a la página de configuración del módulo (Configuration -> Payment Gateways), selecciona Paygol y haz click en “Edit”.
  • Ingresa el ID de Servicio y Secret Key de tu cuenta de Paygol (puede ser encontrado en la sección “Notificaciones” de tu panel de Paygol).
  • Asegúrate de que el módulo está configurado como se indica a continuación:
    – “Enabled: Yes”.
    – “Allow one time payments: Yes”.
    – “Enable test mode: No”. (Favor de leer la sección “Pruebas” de este documento para información acerca de cómo probar tu servicio).
  • Copia la URL de IPN proporcionada y pégala en el campo correspondiente de la sección “Notificaciones” de tu panel de Paygol.

Pruebas

  • Para probar el módulo tras su instalación, puedes activar el modo Test en la parte superior de tu panel de Paygol. Asegúrate de cambiarlo de vuelta a modo Live antes de comenzar a vender.

Imagen del botón de pago

Para asegurarte de que todas las instancias del botón de pago de Paygol son mostradas correctamente, por favor sigue las siguientes instrucciones:

  • Edit el archivo “logos.css” de tu instalación de BoxBilling. Este archivo se encuentra en “bb-themes/huraga/assets/css/logos.css”.
  • Agregar las siguientes lineas al final del código “logos.css”:
.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;
}
  •  Guardar cambios.
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”.Ej: “bb-themes/mytheme/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.
    Ej: “bb-themes/mytheme/assets/img/gateway_logos/Paygol.png”.
  • Como alternativa a los puntos anteriores, simplemente cambia el nombre de la carpeta al correcto antes de copiarla a tu servidor.

Notas importantes

  • En modo de pruebas se realizará un llamado IPN (notificación de pago a tu plataforma) inmediatamente después de cada prueba.
  • Una vez un pago sea completado, el mismo se mostrará como completado, pero pendiente de instalación (Pending Setup) hasta que lo actives en tu panel de BoxBilling.
  • Los pagos usualmente son notificados inmediatamente; 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 vouchers que deben ser impresos y pagados en efectivo). En esos casos el producto se mostrará como no pagado, y sólo una vez sea confirmado por el proveedor se mostrará como pagado. Recomendamos que informes a tu clientela sobre ésto a modo de evitar confusiones.