Instructions for Tinkoff Crediting

What the add-on does

The add-on adds a CS-Cart payment processor for applying for a loan or installment plan through Tinkoff. When this payment method is selected, the store sends Tinkoff an application with the order amount, products, shipping, customer contact details, and return links, receives a bank form link, and redirects the customer to it.

Where the add-on is located

Add-on settings are located on the add-on card: Add-ons → Manage add-ons → Tinkoff crediting.

The payment processor settings are used in a CS-Cart payment method: Administration → Payment methods. Select MS: Tinkoff crediting in the processor list.

General add-on settings

Test mode — switches the application creation endpoint. In test mode the add-on sends the request to create-demo; in live mode it sends the request to create.

Payment method settings

Shop ID — the store identifier issued by Tinkoff.

Showcase ID — the storefront/showcase identifier issued by Tinkoff.

Promo code — the Tinkoff credit product code. If the field is left empty, the add-on sends default.

The add-on does not expose separate API token, Client ID, Secret Key, or Merchant ID fields: application creation uses the Shop ID, Showcase ID, and Promo code from the payment method.

Status mapping

The Statuses section of the add-on card maps Tinkoff scenarios to CS-Cart order statuses:

Fail — default status F.

Success — default status O.

Return — default status D.

Webhook — default status F.

If the store has multiple storefronts, select a specific storefront before configuring statuses.

How the application flow works

1. The customer places an order and selects the Tinkoff crediting payment method.

2. The add-on collects products, shipping cost, total amount, first name, last name, phone, and email from the order.

3. Tinkoff receives the Shop ID, Showcase ID, amount, order number, order items, contact details, and Promo code.

4. The add-on automatically adds successURL, failURL, returnURL, and webhookURL through CS-Cart payment_notification.* routes.

5. If Tinkoff returns the application ID and link, the add-on saves them in the order and redirects the customer to the bank form.

6. After customer return or webhook notification, CS-Cart finishes the payment and applies the mapped status.

Callback, webhook, and return links

There is no separate field for manually entering a webhook URL. The add-on generates callback links automatically:

successURL — successful customer return.

failURL — return after an error.

returnURL — return after cancellation or general exit from the bank form.

webhookURL — Tinkoff notification through payment_notification.webhook.

Order data

The order card for this payment method shows:

Transaction ID — the Tinkoff application ID.

Client link — the link to the bank application form.

Limitations and important notes

The add-on creates a credit/installment application and redirects the customer to Tinkoff; it does not manage hold/capture, charging, cancellation, refunds, or manual application status checks from the admin panel.

The add-on has no separate fiscalization, 54-FZ receipt, or DigitalKassa settings.

Products, shipping, and amounts are sent to Tinkoff from the CS-Cart order data at the moment this payment method is selected.

If Tinkoff returns errors or validations instead of a link, the add-on displays a notification and does not redirect the customer.

How to check the result

1. Enable test mode in the add-on settings.

2. Create or open a payment method with the MS: Tinkoff crediting processor.

3. Enter test Shop ID, Showcase ID, and Promo code if needed.

4. Check status mapping for success, fail, return, and webhook scenarios.

5. Place an order on the storefront and select this payment method.

6. Make sure the customer is redirected to the Tinkoff form.

7. Return from the bank scenario and check that the order received the expected status and that the application ID and client link were saved in the order.