YooKassa (outdated protocol)

To add YooKassa, you need to configure the settings on the payment gateway side and add the module in BILLmanager.

This module uses the outdated protocol, so it can be configured for those users of YooKassa who got registered before the new protocol was released. 

* — to enable your clients to create subscriptions, when configuring integration with this payment method, choose Bank Card and/or YooMoney as the payment method. Subscriptions will not work for other payment methods.

Configuring the payment method

Login to the payment gateway, navigate to the Settings section, and enter the following parameters: 

• Check URL — https://<BILLmanager_address>/mancgi/ymcheck.
• Aviso URL — https://<BILLmanager_address>/mancgi/ymresult.
• Success URL — enter the URL for successful payments: https://<BILLmanager_address>/mancgi/ymsuccess.
• Fail URL — enter the URL for unsuccessful payments: https://<BILLmanager_address>/mancgi/ymfail.
• Email for payment lists — every month the system will send a list of payments to this email.
• ShopPassword — enter the shop password. This is a sequence of random symbols 20 characters long. 

Once completed click  Save and Next. The setting will be checked by YooKassa staff. If they are correct, the user will receive Shop ID and scid that he will need to enter 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:

1. Select a payment methods: "YooKassa".
2. Integration settings. Specify the data for integration:
   Activate the Add New Client option to display a link to register with the handlers system.
   Complete the form using the details of an existing client in the handlers system:
   
   1. Shop name — enter the name of your shop or service. 
   2. Shop id  — shop number in YooMoney. 
   3. Shop window id — number of the shop window in YooMoney.
   4. Payment method — select a payment method. You can select those methods that are specified in your agreement with YooKassa.  
   5. Protocol version — enter your protocol version. May vary depending on your registration period.
   6. Test mode — select the check box to enable a test mode for payments. 
   7. Recurring payments — select the check box to enable recurring payments. 
   8. Allow refund — select the check box to enable refunds. 
3. Payment method settings. Configure internal (within BILLmanager) parameters of the service payment module. For more details, see How to add a payment gateway module.

Configuring recurring payments

To activate recurring payments, register your site at YooMoney web-site. Click on the link→ Back to service, and fill out the form that will open. 

• Name — enter the name of your shop. It will be shown to your customers.
• Site URL — the web-site where customers can make payments.
• Email — email for notifications from YooMoney.
• Redirect URI — https://<BILLmanager_address>/mancgi/ymrecurringresult.
•  Logo — upload your logo.
• Check application identification — select the check box.

Once completed, click Confirm. The site will generate the "ID" (application identifier) and the «Secret word».You need to specify them in the payment method configuration form in BILLmanager:

Configuring refunds 

To enable the refund option, please contact YooMoney staff. You need to enter the parameters that they will give you in the payment method configuration form in BILLmanager:

• Path to the certificate file, Path to the key file, Path to the root certificate, Path to the certificate file — certificate files.  
• URL — enter the URL for payment refunds: https://penelope.yamoney.ru/webservice/mws/api/returnPayment.
• Billing IP — the IP address that will send requests to the payment system. 

Logging

YooKassa has the following log files:

• /usr/local/mgr5/var/pmyandexmoney.log — configuration details of the payment method.
• /usr/local/mgr5/var/ympayment.log — payment log.
• /usr/local/mgr5/var/ymresult.log — responses from the payment gateway.