CloudPayments

To use the CloudPayments payment module, you need to connect the module in BILLmanager. 

Payment methods support
Bank cards	Cash	E-wallets	Mobile payments	Online banking
Supported features
Payments return		Recurring payments		Subscriptions

Installing the module

1. If you are using a BILLmanager version lower than 6.103.0, update the platform.
2. Connect to the server with the platform via SSH.
3. Copy the BILLmanager repository: 
   

   git clone https://github.com/ISPsystemLLC/billmanager

4. Go to the module directory: 

   cd billmanager/paymethod/cloudpayments

5. Run the installation: 

   sh install.sh

   The script will copy the module to the /usr/local/mgr5/src/ directory and run make install command to install it. After the module is installed, the platform will restart and the payment method will be available for configuration.

Configuration on the BILLmanager side

To create a payment module, enter Provider → Payment methods → click Add. 

1. Selecting the payment module:  "CloudPayments".
2. Integration setup. Specify data for integration from the site settings in CloudPayments personal cabinet:
   
   1. Public ID.
   2. API Secret.
3. Payment method setup. Configure internal (within BILLmanager) parameters of the service payment module. For more details, see How to add a payment gateway module.

Additional information

Logs

Logs of interaction between the billing platform and CloudPayments are written to files:

• /usr/local/mgr5/var/cpwidgetpayment.log — CGI script log for creating a payment form
• /usr/local/mgr5/var/cpwidgetrecurring.log — CGI script log for creating an autopayment or saved payment method
• /usr/local/mgr5/var/cpwidgetresult.log — CGI script log for payment status processing
• /usr/local/mgr5/var/cpwidgetrecurringresult.log — CGI script log for processing the status of creating an autopayment or saved payment method
• /usr/local/mgr5/var/pmcloudpaymentswidget.log — log of the main payment module

Module structure

• /cloudpayments — directory with auxiliary functions for working with CloudPayments API
• /dist — directory contains HTML form for payment, 404 page template and png image for payment method
• /xml — directory contains XML file with description of the form interface
• Makefile — script for copying files to required directories
• pmcloudpaymentswidget.py — main module of the payment system handler
• cpwidgetpayment.py — CGI to enter the payment system for a regular payment
• cpwidgetrecurring.py — CGI to enter the payment system for setup payment to recurring payments
• cpwidgetrecurringresult.py — CGI for recurring payment confirmation processing
• cpwidgetresult.py — CGI for processing confirmation of regular payments