To add UnitPay, you need to configure the settings on the payment gateway side and add the module in BILLmanager.
Configuring the payment method
Log in to UnitPay and enter the following configuration details:
- PUBLIC KEY — your shop identifier. It is used to identify a payee and is specified in the payment configuration form in BILLmanager.
- Redirect client to special pages — check the box.
- Success URL — enter the URL for successful payments: https://<BILLmanager_address>/billmgr?func=payment.success.
- Fail URL — enter the URL for unsuccessful payments: https://<BILLmanager_address>/billmgr?func=payment.fail.
- Payment handler — enter the URL: https://<BILLmanager_address>/mancgi/unitpayresult.
- SECRET KEY — enter the key for payment signature verification. It is used in payment method configuration from in BILLmanager.
Configuring BILLmanager
The module is installed from the latest available version of the product and requires an update of the BILLmanager platform, because the module version cannot be higher than the platform version.
To create a payment module, enter Provider → Payment methods → click Add. The payment module adding wizard consists of the following steps:
- Select a payment methods: "UnitPay".
- Integration settings. Specify the data for integration:
- PUBLIC KEY — enter the merchant public key. You can obtain it inside your UnitPay account in the "Payment form" section of the online shop you are trying to integrate with.
- SECRET KEY — enter the secret key. You can obtain it inside your UnitPay account in the Settings section.
- Payment method settings. Configure internal (within BILLmanager) parameters of the service payment module. For more details, see How to add a payment gateway module.
Additional information
Refund
Refund is not supported.
Logging
UnitPay has the following log files:
- /usr/local/mgr5/var/pmunitpay.log — configuration details of the payment method.
- /usr/local/mgr5/var/unitpaypayment.log — payment log.
- /usr/local/mgr5/var/unitpayresult.log — responses from the payment gateway.