T-bank

 To use the T-bank payment module, you need to register in the payment system and configure the module in BILLmanager.

Supported payment methods
Bank card	Cash	E-wallet	Mobile payment	Internet banking
Maestro, Mastercard, Visa, «Мир»			Google Pay, Apple Pay
Supported features
Payment return		Recurring payments		Subscriptions

Configuration on BILLmanager side

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: "T-bank".
2. Integration settings. Specify the data for integration:
   Activate the Add New Client option to display a link to register with the handler's system.
   Complete the form using the details of an existing client in the handler's system:
   
   1. Terminal ID — terminal ID for connecting to the Tinkoff API. These details are provided when you register in the payment system;
   2. Terminal password — terminal password for connecting to the Tinkoff API. These details are provided when you register in the payment system;
   3. Use the terminal notification URL — determines where the link will be sent to clients when they make payments:
      
      • option enabled — from the terminal's client area;
      • option disabled — from BILLmanager.

   4. Recurring payments — the option includes use of recurring payments and creation of saved payment methods. Recurring payments in BILLmanager are used for automatic personal account topup. If you set up auto-payment on the client side, the payment of 1 ruble will be made automatically. This is necessary to confirm that the bank card is active. When the recurring payment activation procedure is completed, this payment will be canceled.

      1. If the option is active, specify:

         • Return page upon successful auto-payment — page to which the payer will be redirected upon successful auto-payment. Use the BILLmanager page https://domain.com/billmgr?func=payment.recurring.success or any custom page;
         • Return page upon failed auto-payment — page to which the payer will be redirected upon failed auto-payment. Use the BILLmanager page https://domain.com/billmgr?func=payment.recurring.fail or any custom page;
         • Return page upon auto-payment in processing — page to which the payer will be redirected upon auto-payment in processing. Use the BILLmanager page https://domain.com/billmgr?func=payment.pending  or any custom page.
         Comments

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

         Creation of recurring payments is confirmed only by notifications. If BILLmanager does not receive a notification from T-Bank, new auto-payments or saved payment methods will not be created.

         Already created auto-payments and SSO will work even without notifications.

   5. Taxation system — allows you to choose the system of taxation used to be specified when a receipt is generated;
   6. Allow payment refund --- if this option is enabled, payment refunds are allowed.
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.

Additional information

Payment refund

To allow payment returns, enter Provider → Payment methods → Edit button → Allow payment refund option. Refunds are supported for payments with the “Credited” status.

Logging

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

• /usr/local/mgr5/var/pmtinkoff.log — log file of payment module settings, recurring payments and refunds, scheduled check of payment statuses;
• /usr/local/mgr5/var/tinkoffpayment.log — payments log file;
• /usr/local/mgr5/var/tinkoffnotification.log — notifications log file;
• /usr/local/mgr5/var/tinkoffrecurring.log — recurring payment settings log file.