Tinkoff Payments
This add-on is part of our Subscription plan.
Subscribe once — enjoy all add-ons without limits.
Tinkoff Payments adds a Tinkoff API payment method to a CS-Cart marketplace and helps split order payments between vendors. The add-on registers vendors as marketplace shops in Tinkoff, stores their shop IDs, and passes the split data when an order is paid.
What it is for
The add-on is useful for marketplaces that accept payments through Tinkoff and need to automatically divide an order amount between several vendors. It reduces manual payment preparation for each vendor: the administrator maps vendor profile fields to Tinkoff requirements, registers the vendor shop, and then uses the received shop ID during checkout.
Key features
- adds the “Tinkoff Payments” payment processor for CS-Cart orders;
- supports production and test Tinkoff API modes;
- stores common integration credentials: username, password, and marketplace fee percentage;
- maps vendor profile fields to the company details required by Tinkoff for shop registration;
- adds a Shop ID field and a vendor registration action to the vendor profile;
- sends vendor split data in the payment request: shop ID, amount, and marketplace fee;
- handles successful and failed returns from the payment page and assigns the corresponding CS-Cart order status.
How it works
The administrator configures Tinkoff API credentials, enables test mode if needed, and sets the marketplace fee percentage. Then the required Tinkoff registration fields are mapped to vendor profile fields: company name, tax IDs, address, manager details, bank details, and other fields.
A “Tinkoff Payments” block appears in the vendor profile. It can be used to register the vendor in Tinkoff and receive the shop ID. When a customer places an order, the add-on creates a payment in Tinkoff API, adds the order vendors to the request, and redirects the customer to the payment page. After a successful or failed payment result, the order receives the corresponding status.
Have questions about the add-on?
- English
- Русский
- 4.18.X
Instructions for Tinkoff Payments
What the add-on does
The add-on adds a “Tinkoff Payments” payment method to a CS-Cart marketplace. The customer pays on the Tinkoff payment page, while the add-on passes vendor split data in the payment request: vendor shop ID, amount, and marketplace fee percentage.
The add-on also helps register vendors in Tinkoff as marketplace shops. The administrator maps vendor profile fields to the company details required by Tinkoff and starts the registration from the vendor profile.
Where to find the add-on
Main settings are available in the add-on card: Add-ons → Manage add-ons → Tinkoff Payments.
The payment method is configured in Administration → Payment methods. Select MS: Tinkoff Payments as the payment processor.
The vendor Shop ID field and registration action are available in the vendor profile in the MS: Tinkoff Payments block.
Add-on settings
Username — login for the Tinkoff vendor registration API.
Password — password for the Tinkoff vendor registration API.
Test mode — enables test Tinkoff API endpoints. In test mode, the add-on uses the test payments API and the test vendor registration API.
Deductions in favor of the marketplace in % — the marketplace fee percentage passed to Tinkoff API in vendor split data.
Matching vendor profile fields — a table where each Tinkoff field is mapped to the corresponding CS-Cart vendor profile field.
Vendor fields available for mapping
The add-on supports mapping company details: full and short company name, name for SMS and 3DS, INN, KPP, OGRN, legal address, email, website, bank account, bank name, BIK, and payment purpose.
It can also map founder and CEO details: full name, citizenship, address, date of birth, and phone. If the country field in CS-Cart stores a two-letter country code, the add-on converts it to a three-letter ISO code before sending it to Tinkoff.
For vendors without KPP, the add-on sends 000000000 if KPP has not been formed from the mapped fields.
Payment method setup
Create or open a payment method and select the MS: Tinkoff Payments processor. In the processor settings, fill in Terminal ID — the TerminalKey from the Tinkoff account.
The add-on uses one-step payment: the payment request contains PayType = O. There are no separate interface settings for hold, manual capture, cancellation, or refund.
Registering a vendor in Tinkoff
Before registering a vendor, fill in the vendor profile with the data selected in the add-on field mapping.
Open the vendor profile and click Register a store in the MS: Tinkoff Payments block. The add-on receives an access token through the registration API, sends the vendor data to Tinkoff, and saves the returned Shop ID in the vendor profile.
If Tinkoff returns field errors, the add-on shows a notification with the affected field name and the error text. After fixing the data, registration can be repeated.
Payment flow
During checkout, the add-on sends an Init request to Tinkoff Payments API with the terminal ID, order amount in kopecks, order ID, storefront language, and success/fail return URLs.
For each vendor product group, the add-on checks the saved Shop ID. If the ID exists, the vendor block is added to the payment request with the shop ID, the amount for this vendor’s products, and the marketplace fee percentage.
After a successful Tinkoff API response, the customer is redirected to the returned PaymentURL.
Webhook and statuses
The add-on code has no separate webhook URL setting. Payment results use standard CS-Cart callback URLs:
payment_notification.success?payment=ms_tinkoff_payments&order_id=<order ID>
payment_notification.fail?payment=ms_tinkoff_payments&order_id=<order ID>
On a successful result, the order is assigned the default Open status. On a failed result, the order is assigned the default Failed status. Status mapping in the add-on interface is not implemented in the current version.
Refunds, cancellations, and receipts
The add-on interface has no separate refund, cancellation, hold confirmation, or manual capture operations. If these operations are required, perform them through the Tinkoff account/tools and the standard CS-Cart order actions.
The add-on has no separate settings for fiscal receipts, 54-FZ, or DigitalKassa integration. If fiscalization is required, check the workflow on the Tinkoff side and with the receipt add-ons used in the project.
How to check the result
1. Enable test mode and fill in test Tinkoff API credentials.
2. Map the required vendor fields and fill in the test vendor profile.
3. Register the vendor from the vendor profile and make sure the Shop ID appears.
4. Create a payment method with the MS: Tinkoff Payments processor and a filled Terminal ID.
5. Place a test order with products from a vendor that has a saved Shop ID.
6. Check that the customer is redirected to the Tinkoff payment page.
7. After successful or failed payment, check the order status in CS-Cart.
Change history
v1.0.3 from 2026-01-27
[*] Replaced short <? tags with standard <?php tags
[+] Added add-on description and instructions
[*] Adjusted design elements
[+] Added the “Tinkoff Payments” payment processor for CS-Cart
[+] Added test and production connection settings for Tinkoff API
[+] Added username, password and marketplace fee percentage parameters
[+] Added mapping of vendor profile fields to the details required for Tinkoff shop registration
[+] Added vendor registration in Tinkoff from the vendor profile with saving the shop ID
[+] Added sending order vendor data to the payment request for payment splitting
[+] Added handling of successful and failed customer returns from the payment page
Legend:
[+] Added
[-] Removed
[*] Changed
[!] Bug fix
Here you can share your opinion and evaluate our work.
Your feedback helps us become better and offer you even better service.