YooKassa (New 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 new protocol, and we recommend that all new users configure it to accept payments from customers. 

Payment methods support
Bank cards	Cash	E-wallets	Mobile payments	Online banking
Visa, Mastercard, Maestro, Mir, JCB.	Terminals, ATMs, bank cash desks.	QIWI Wallet, WebMoney, YooMoney.	Beeline, Megafon, MTS, Tele2.	Alpha-Click, Sberbank Online.
Supported features
Payments return
Recurring payments
Subscriptions*

* — 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

To configure YooKassa:

1. Enter the client area or register at YooKassa website. Read more about how to register in YooKassa documentation.

2. In the client area, enter the section Integration → Ready-made solutions.
   
   

   "Integration" section in YooKassa client area

   Note:

   To be able to select integration with BILLmanager in this section, specify the address of BILLmanager in the section Contract → Payments acceptance.

3. Select BILLmanager from "Your system" list and press Save.
   
   

   Selection of BILLmanager payment module on the YooKassa side

   
   

The parameters required for integration with BILLmanager will appear in your client area:

• in the section Settings → Store — shopId;
• in the section Integration → API keys — secret key.

ShopId — the unique store ID in YooKassa system used to configure integration on BILLmanager side.

Secret key — the secret key of the store used to configure integration on BILLmanager side.

Configuring recurring payments on the Yookassa side

To set up recurring payments in Yookassa, you need to:

1. Write a message to the Yookassa manager from your Client area. To do this, click on the operator icon in the upper right corner.
2. In the Problem solving section, write a message. For example: "I want to connect recurring payments. How do I do it?"
3. The answer from the Yookassa manager with instructions for further action will be sent to your email.

Possible instructions by Yookassa

As a rule, you will be asked to send a screenshot of your website showing how the client can unlink their card. To create such a screenshot:

1. Create a test client in your BILLmanager.
2. Log in to BILLmanager with that user's permissions.

3. Enter the client area settings → Payment methods.
   

   • In BILLmanager 5 interface
   • In BILLmanager 6 interface

   

   
   

   

4. Save the test bank card. Read more about how to save and delete a bank card in BILLmanager, in Payment methods1.
5. Create a screenshot that will show:
   • the possibility to unlink the payment method;
   • the browser address line.

• In BILLmanager 5 interface
• In BILLmanager 6 interface

Configuring BILLmanager

Navigate to Provider → Payment method and complete the following fields:

• Step 1 — Select a payment method — choose "YooKassa".
• Step 2 — Integration settings. Enter the integration details. 
• Step 3 — Payment method settings. Enter the payment method parameters. 

Integration 

Shop id — enter your ShopId. 
Secret key — enter your Secret Key. 
Payment method — select one or more payment methods available for this payment module;
Recurring payments — select the check box to enable recurring payments. Recurring payments are used in BILLmanager for  Account automatic replenishment or to create Subscriptions. If the flag is active, specify the following:

• Return page for a successful auto payment — a link to return from your YooKassa client area after a successful configuration of auto payment. Use the BILLmanager page https://domain.com/billmgr?func=payment.recurring.success or an arbitrary page;
• Return page for an unsuccessful auto payment — a link to return from your YooKassa client area after an unsuccessful configuration of auto payment. Use the BILLmanager page https://domain.com/billmgr?func=payment.recurring.fail or a discretionary page;

• Return page for an auto payment configuration in progress — a link to return from your YooKassa client area the configuration of the auto payment is in progress. Use the BILLmanager page https://domain.com/billmgr?func=payment.pending or a discretionary page.

  Comments

  domain.com — domain name or public IP address of the server with BILLmanager.

On the edit form of the newly created payment gateway you can check the Allow refund box to enable refunds.  

Redirecting after payment

This payment method supports the function for redirecting the customer after payment to a discretionary page. Use different pages depending on the success of the payment. For example, BILLmanager pages:

• for a successful payment:  https://domain.com/billmgr?func=payment.success;
• for an unsuccessful payment:  https://domain.com/billmgr?func=payment.fail;

• for payments in progress:  https://domain.com/billmgr?func=payment.pending.  

  Comments

  domain.com — domain name or public IP address of the server with BILLmanager.

To specify return pages when creating a payment method, go to step three and fill in the fields Successful payment return page ,  Failed payment return page and Pending payment return page . You can also specify them after creating the payment method in Provider → Payment methods → Edit → Settings block.

Payments refunds

To permit refund of payments:

1. Complete the creation of the payment method.
2. Enter Provider → Payment methods → Edit → Refunds block.
3. Enable the Allow payment refunds option and press Ok to save your settings.

Logging

YooKassa has the following log files:

• /usr/local/mgr5/var/pmyandexcheckout.log — configuration details of the payment method;
• /usr/local/mgr5/var/ycpayment.log — payment log;
• /usr/local/mgr5/var/ycrecurring.log — recurring payments;
• /usr/local/mgr5/var/ycresult.log — responses from the payment gateway.