MS: Tochka Bank Module Instruction

Installation

1. Install and enable the MS: Tochka Bank add-on.
2. Make sure the pdf_documents add-on is installed, because it is used for beneficiary and deal document templates.
3. After installation open Administration → Add-ons → MS: Tochka Bank.

API access preparation

1. Submit a request to Tochka Bank for test/preprod API access and provide the store server IP address.
2. On the General tab click the key generation button.
3. Send the var/ms_data/ms_tochka_bank/keys/rsaacert.pem file to Tochka Bank.
4. After approval, fill in the sign-system, thumbprint, nominal account, and BIC settings.

Module configuration

The add-on includes three main settings tabs.

• General — test mode, nominal account details, key management, logging, and test transfer.
• Beneficiary information — mapping of vendor profile fields to Tochka Bank fields, including passport data, registration address, registration country code, and tax residency flag.
• Additional information — service tab with additional module notes.

If vendor data is stored in separate profile fields, create those fields first in Administration → Profile fields → Vendor information and then map them in the module settings.

Usage

1. Beneficiary registration

1. Open the vendor card and fill in the Tochka Bank fields.
2. For a legal entity, fill in the TIN, company name, and KPP.
3. For sole proprietors, self-employed persons, and individuals, fill in the full name, birth data, passport data, registration address, registration country code, and tax residency flag when those fields are mapped.
4. Use the beneficiary action button or save the vendor card to create or update the beneficiary.
5. After successful processing, verify that the beneficiary ID, beneficiary document, and virtual account are stored for the vendor.

2. Documents

1. The add-on can upload a beneficiary document from a file or generate it automatically from a template.
2. Deals use a dedicated PDF document generated through the deal_invoice document type.
3. The vendor card can display beneficiary document data and validation statuses returned by Tochka Bank.

3. Payments and payouts

1. Enable the Tochka Bank option in the required payment method.
2. Go to Orders → Tochka Bank Payments to review incoming payments, internal payments, and deals.
3. Use automatic distribution on the payments page to match incoming funds to orders and vendor virtual accounts.
4. For payouts, the vendor creates a withdrawal request in accounting, and the administrator confirms the payout and creates a deal.

Verification

1. Enable test mode and run a test transfer from the module settings.
2. Check the API connection test after entering keys and account details.
3. Create a test vendor and confirm that the beneficiary ID and virtual account appear after saving.
4. Verify that beneficiary document data and validation statuses are visible on the vendor page.
5. Create a test order with Tochka Bank payment and make sure the payment appears on the Tochka Bank Payments page.
6. Create a test payout and confirm that the add-on generates both the deal and the deal document.

Troubleshooting

• No API access. Check that Tochka Bank has allowed the store server IP and that the module keys and account details are filled in correctly.
• Beneficiary is not created. Check that all required vendor profile fields are filled in and mapped correctly.
• No virtual account appears. Make sure the beneficiary was created successfully and the beneficiary document was uploaded or generated.
• Passport data or registration address becomes 0. Correct the vendor field values and save the vendor card again.
• PDF documents are not generated. Check the pdf_documents add-on and the document templates configured for this module.

Key module files

• app/addons/ms_tochka_bank/addon.xml — add-on scheme and settings
• app/addons/ms_tochka_bank/controllers/backend/ms_tochka_bank.php — backend pages for payments, deals, and test actions
• app/addons/ms_tochka_bank/controllers/backend/companies.post.php — integration with the vendor card
• app/addons/ms_tochka_bank/Tygh/Addons/MsTochkaBank/MsTochkaBank.php — main Tochka Bank API client
• app/addons/ms_tochka_bank/Tygh/Addons/MsTochkaBank/Entities/Beneficiary.php — beneficiary management logic
• app/addons/ms_tochka_bank/resources/document_templates.xml — beneficiary and deal document templates
• app/addons/ms_tochka_bank/info/*.html — module description, instruction, and changelog