Paygol module v1.1 for BoxBilling



  • Working BoxBilling installation (tested with version 4.20).
  • Paygol account.


  • Download BoxBilling module.
  • Unzip directly into your Boxbilling folder.
  • To install the module, go to your BoxBilling administration panel (Configuration -> Payment Gateways), select Paygol at the “New payment gateways” tab, then click “Install”.
  • Once installed, proceed to the module’s configuration page (Configuration -> Payment Gateways), select Paygol and click “Edit”.
  • Enter both the Service ID and Secret Key of your Paygol account (can be found at the “Notifications” section of your Paygol dashboard).
  •  Make sure that the module is configured as follows:
    – “Enabled: Yes”.
    – “Allow one time payments: Yes”.
    – “Enable test mode: No“. (please check the “Testing” section of this document for information on how to make test transactions).
  • Paste the provided URL into the IPN URL field at the “Notifications” section of your Paygol dashboard.


  • To test the newly installed module, you can enable your account’s Test mode on top of your Paygol dashboard. Be sure to change it back before going live.

Paygol button image

In order for all instances of the Paygol button to be shown correctly, please do as follows:

  • Edit “logos.css” from your BoxBilling installation. It’s located at “bb-themes/huraga/assets/css/logos.css”.
  • Add the following lines to the end of the file.
background: transparent url("../img/gateway_logos/Paygol.png") no-repeat scroll 0% 0%;
background-size: contain;
height: 28px;
border: 0;
margin: 10px;
  •  Save changes.
Please note:

If you are not using the default theme “huraga”, you need to do the following:

  • Modify the CSS file on the right folder, not in “huraga”. e.g. “bb-themes/mytheme/assets/css/logos.css”.
  • Copy image “bb-themes/huraga/assets/img/gateway_logos/Paygol.png” to a similar path for the other theme.
    e.g. “bb-themes/mytheme/assets/img/gateway_logos/Paygol.png”.
  • As an alternative to the previous steps, just rename the folder name with the right one before copying it to your server.

Important Notes

  • While in test mode, an IPN request (payment notification) will be issued immediately to your platform after each test.
  • After a payment is completed it will be shown as completed but Pending Setup until you activate it at your BoxBilling panel.
  • Payments are usually notified immediately; however, certain payment methods may take longer to confirm the payment (e.g. methods that take a few minutes to notify the transaction, or voucher-based transactions that require the payer to print it in order to pay by cash at a given place). In these cases the product is shown as not paid, and only once it’s confirmed by the provider will it show as paid. We strongly recommend that you inform your customers about this beforehand in order to avoid confusions.