T-Bank Internet Acquiring Payment Processing

The payment system is created during installation. The module creates it automatically and immediately offers to proceed to its settings—you only need to enter the terminal ID and password. It is created in a disabled state so that the buyer cannot see it before it is configured.

Settings can be migrated from the tinkoff.payment module. If it is installed on the site, during installation you are offered to create a payment system based on its settings: the terminal ID, password, and invoice parameters are transferred automatically, and the previous payment system is disabled. Restrictions are transferred via a separate checkbox.

Custom icons for each payment method—card, SBP, T-Pay, and pop-up widgets—are now provided, so you no longer need to manually select images.

The invoice now includes calculation method indicators: 'partial payment and credit', 'transfer to credit', and 'credit payment'.

The "T-Bank Operations" tab in the order card. For each payment, the bank status, the assigned order status, the confirmed amount, and the sending of the closing receipt are visible. Nearby is the operations log: which notifications were received from the bank and whether they were accepted, what the module did, and who initiated it — the bank, the operator, or the agent. Previously, this could only be determined from the log if it was enabled in advance. The log is maintained independently of system logging, and the storage depth is configurable.

Rejected bank notifications are visible along with the rejection reason — these explain why the payment "did not arrive."

Two-stage payments no longer appear unsuccessful to the buyer. After reserving funds, the order is not marked as paid, and the result page previously displayed this as an error. Now the buyer sees that the funds are reserved and will be debited after the order is confirmed by the store.

Sending the payment link checks the email template. If it is missing, disabled, or not linked to the order's website, the module reports this immediately instead of showing a failed send.

Payment status has been moved to the module's own table. Previously, it was stored as rows in the site settings and read entirely on every access to the module. During updates, the data is automatically migrated.

After installation, a "Go to Module Settings" button is added.

An intermediate status has been added to the successful payment redirect page: Payment accepted by the bank; the status will be updated within a few minutes.

The hold confirmation has been redesigned: an order can no longer appear as paid if the bank failed to debit funds due to an error. If the bank rejects the payment, the button in the order card displays the actual reason, remains in place, and the attempt can be retried immediately.

Fixed: reserved funds are no longer lost due to connection interruptions. A single connection failure no longer removes the payment from processing; the next attempt will resume it.

Discovered vulnerabilities have been patched.

Security. Payment status verification has been moved from a custom public endpoint to the standard Bitrix service.

Fixed: an order that was not cancelled no longer appears as cancelled. If something blocked the order cancellation after a refund or hold release, this was previously silently ignored and logged as success. Now the administrator receives a notification.

Fixed: the payment form layout in the Aspro theme — when automatic redirection to the bank is disabled, an unclosed tag broke the page markup.

The onBeforeActionReverse event has been enhanced — the store handler can now override the result of hold release processing, as was already possible for payment, refund, rejection, and authorization.

Refactoring: obsolete and unnecessary module files have been removed

Failure notifications. The module informs the administrator about issues that were previously visible only in the log: payment amount mismatch, bank notification rejected, closing receipt not sent, hold not released, buyer saw an error instead of the payment form. Delivery is handled by the free "Error Notifications" module (rover.notifier) — via email, SMS, or messenger. Two independent checkboxes on the "Debug" tab: critical failures are sent immediately, buyer errors are grouped.

The hold auto-confirmation agent no longer stops at the first error — previously, a failure on one payment left all others unconfirmed.

Settings now work in editions without "Online Store": the "Debug" tab with logging and notifications is available there as well.

Payment information processing security has been enhanced.

Discovered vulnerabilities have been fixed

Fixed errors during installation and removal

One-click payment confirmation. In the order card in the admin panel, a button "Confirm payment in T-Bank" has appeared. For orders with two-stage payment (funds are reserved but not yet deducted), there is no need to wait for automatic confirmation via timer or access payment system settings: payment can now be confirmed directly from the order in an obvious way.

Manual sending of payment link. A new button "Send payment link" allows the manager to send the buyer an email with a fresh payment link for the order with one click if payment has not yet been completed or ended with an error that can be corrected by retrying. The email template includes the amount, order number, and website name, and can be freely edited in "Mailings" as a standard email event.

Fixed an error in the tinkoff.order.payform component, which caused the buyer to see an empty line instead of a clear error message when payment failed.

— root certificates of the Ministry of Digital Development have been connected

— enhanced security verification of incoming notifications from the bank

— other identified security issues have been fixed

— the mechanism for protecting against duplicate notifications has been strengthened against load

— a limit on the depth of the stored log has been added (in days) + the log has been moved to a folder with a random name

— translation into English has been completed

— notices fixed for PHP 8.2

— other minor errors have been fixed

— refactoring

— separate VAT selection has been added for deliveries

— the ability to pass VAT directly from the product to the receipt has been added

— a template has been added that displays correctly in the personal account of Aspro sites

— the module settings now include the 'Block repeated notifications from the bank' option, which allows eliminating duplicate receipts when connecting a cash register via Bitrix. Available only for editions with the 'Online Store' module

— the 'Block repeated notifications from the bank' setting has been forcibly enabled for those who installed the module before this setting appeared.

— new VAT values have been added: 22% and 122/22

— the option 'Open payment page in a new window' has been added for card payment and T-Pay

— added an additional check to filter out redundant notifications from the bank and prevent unwanted order status changes after payment.

— fixed the error 'Order with such order_id already exists', which occurred when reopening the payment popup widget

— restored automatic opening of the T-Pay widget and card payment widget in the personal area

— fixed payment via T-Pay and the SBP popup widget from the personal area

— fixed other minor errors and inaccuracies

— added the ability to automatically release payment reservation upon order cancellation (two-stage payments)

— clarified setting descriptions

— fixed an error that could prevent the payment status from being set and the order status from changing on the site

— from this version, a timestamp will be added to the order number in the T-Bank account to prevent the error 'Invalid transaction status. (Order with such order_id already exists.) [8]'

— added the ability to specify a template for the order link in the user's personal area. Available only for editions with the 'Online Store' module

— fixed an error that could cause incorrect success/failure payment messages to be displayed

— Added VAT 5% and 7% and VAT calculation for supply 5/105 and 7/107

— Fixed card saving

— Added extended error output during payment initialization

— Added translation to the English version

— Other minor insignificant fixes

— To better comply with the fiscal data format, if the payment method is "prepayment", "prepayment 100%" or "advance", the item type flag is set to "payment", and the flag set in settings is transmitted only in the closing receipt

— Added a check to ensure that the number of closing receipts for a single payment does not exceed one

— Fixed an error that caused the closing receipt to not always be sent correctly

— For SBP, added the ability to automatically redirect to the bank payment page

— Fixed an error that prevented printing receipts if the unit of measurement was not specified in the cart item

— Fixed an error that could cause the payment acceptance component to malfunction without an online store when receipt printing is enabled

— In the settings of the 'T-Bank Payment Form (without online store)' component, the ability to specify information for printing a receipt has been added. This allows printing receipts without additional customization. See more.

— The module has been renamed to 'T-Bank Internet Acquiring Payment Acceptance' due to the bank's name change.

— A bug has been fixed that sometimes redirected to an error page after successful payment.

— The English translation has been added.

— The ability to choose when to send a closing receipt has been added: upon shipment (default), upon payment, or upon transferring the order to a specific status.

— The afterBuildClosingReceipt event has been added to allow adjusting the closing receipt. See more.

— Components for payment by order number/order and by payment number/payment have been added.

— The Tinkoff Pay payment method has been added on the site and in the widget.

— The ability to accept payments via SBP in a popup widget on the site has been added.

— The ability to override the text and classes on the payment button has been added.

— An IP restriction has been added for notifications coming from the bank.

— Found bugs and inaccuracies have been fixed.

— added selection of FFD version (1.05 or 1.2)

— added transfer of payer name to the receipt

— added additional calculation item flags for FFD 1.2

— added ability to set a delay before redirecting to the payment page to allow counters to process

— added automatic redirection to the successful payment page when paying via QR

— fixed an error that caused the successful payment page to display that the payment failed.

— added onBeforeGetTinkoffMerchantApi event to allow replacing the payment terminal key and password

— fixed found errors

— regrouped payment system settings

— fixed an error that sometimes prevented automatic redirection to the bank or automatic widget opening

— fixed other found errors and inaccuracies

— tested compatibility with PHP 8

— refactoring

— fixed an error in payment synchronization when multiple payment forms were open on the site simultaneously.

— added the ability to manually set:

text before the payment amount

text with additional description in the lower part

additional description for SBP

error messages

— removed the "Link to Offer" option, as the link to the offer can now be placed in the lower description.

— fixed found errors

— added the ability to save cards, as well as the ability to save separately for each website

— added the ability to specify the receipt type: "full payment", "100% prepayment" or "advance". If "100% prepayment" or "advance" is selected, a closing receipt is also sent upon shipment of the order.

— added compatibility with CRM forms

— added an administrative section (Settings -> Module Settings -> Tinkoff Bank Internet Acquiring (Tinkoff Bank, payment acceptance)) with the ability to enable logging and specify the templates used for the payment system component in the store and on websites24

— redesigned the appearance of payment via QR code: made the payment link more visible

— added the ability to automatically follow the link upon payment via QR code

— added the ability to edit the description before the "Pay" button and under the QR code

— added the ability to display a link to the offer under the payment button

— in the second part of the payment identifier in the bank, the payment number in the store is now placed instead of the ID.

— fixed the display of currency with HTML tags

— minimum PHP version increased to 7.4

— refactoring

— added the ability to specify the order identifier type in the payment identifier

— added the ability to specify the payment link validity period

— improved the notification processing system to prevent duplicate payments/receipts. By default, it is now enabled for new installations.

— fixed a periodically occurring error "Field Receipt must not be empty. (Invalid parameters.)[309]" with correct parameters

— fixed names in receipts and error display for sites using cp1251

— added support for Sites 24. Payment can be added via the "Tinkoff Bank Payment Form" block in the "Online Store" section

— refactoring

— added support for payment in a popup window (widget)

— finally fixed duplicate receipts

— the setting "Payment system view" has been renamed to "Payment system type" and moved to the very top of the form, under the handler selection

— fixed errors in operation without the "Online Store" module

— fixed other errors

— added the ability to automatically change the order status and cancel the order upon payment cancellation

— fixed cancellation and auto-transition to status for an order where reservation cancellation was performed

— fixed duplicate receipts when printing receipts via the website

— fixed other minor errors and inaccuracies

— added the ability to pay only via QR code (SBP). For this, fast payments must be connected in the bank settings, and in the payment system settings, under "Payment System Type", "QR Code" must be specified

— added the ability to select the calculation item for the receipt

— for delivery, the calculation item for the receipt is now "service"

— added the ability to change the template name for each payment system, more details

— payment description restored

— placeholders added to the payment description: #SITE_NAME# — site name, #ACCOUNT_NUMBER# — order number, #DATE_INSERT# — order creation date.

— added the afterGetInitParams event to allow changing data before generating the payment link

— fixed errors that sometimes occur during installation

— added the ability to transition the order to a status upon partial payment

— added events to handle corresponding notifications: onBeforeActionFail, onBeforeActionPay, onBeforeActionRefund, onBeforeActionAuthorize. If the handler returns a value as the third parameter, it will be interpreted as a status and standard processing will not be initiated

— added automatic confirmation of authorized payments after the specified number of days (agents must be active on the site)

— improved compatibility with various versions of the "Online Store" module

— added the onBeforeProcessRequest event, which triggers before processing the payment notification in an online store. If the event handler returns an error result, further notification processing is not performed

— added the onNotification event, which triggers upon receiving a payment notification via the component

— added the ability to specify the order status to which the payment is automatically confirmed during a two-stage payment

— if an empty value is selected in the settings for "Status of authorized order", "Status of paid order", and "Status of order for which a refund or reservation cancellation was made", the statuses will not change for the corresponding events. Previously, a default value was set

— the notification.php file for receiving notifications is no longer required and has been removed from the installation

— bugs fixed

— for two-stage payments, the ability to confirm authorized orders from the store's administrative part has been added. To do this, you must set the payment for the corresponding payment systems in the order

— a payment form component has been added. This allows more flexible use of payment via "Tinkoff Bank", including on lower Bitrix editions without the "Online Store" module. The component is located in the visual menu at "Components Rover" > "Tinkoff Online Acquiring Payment Acceptance" > "Tinkoff Bank Payment Form"

— new fixes have been made to correctly recognize the payment system in case an order has two or more payments

— the minimum version of the main module has been increased to 18.0.2

— encoding errors in the receipt have been fixed

— encoding errors for sites not in UTF-8 have been fixed

— an error that could prevent notifications from arriving has been fixed

— errors during installation on lower Bitrix versions have been fixed

— other found errors have been fixed

— URL settings for HTTP notifications, success pages, and error pages have been moved to the payment system settings. This allows multiple sites to correctly interact with the same payment terminal. If these fields are left empty, values are still taken from the terminal settings

— "Payment Amount" and "Order Number" have been removed from the payment system settings, as they are no longer actually used

— Correct recognition of the payment system has been fixed in cases where an order has two or more payments

— Automatic redirection to the payment gateway has been improved: it can now be connected separately for order checkout or for the personal cabinet, and the address of the page where it will occur can be configured

— A JSON encoding/decoding error has been fixed under certain server settings

— A bug has been fixed that sometimes prevented returning to the store after payment

— Error output for the windows-1251 encoding has been fixed

— Other minor issues and inaccuracies have been fixed.

— added the ability to pay for orders in a currency other than rubles. Immediately before payment, the amount will be converted to rubles at the store's exchange rate.

— transmission of correct (partial) amounts in the receipt for partial payments

— fix for an error that sometimes occurs during refunds

— fix for an error that sometimes caused duplicate payments

— fix for the payment amount error during partial payments

— added the ability to receive the payment status from the order card in the admin panel

— improved the payment button

— refactoring and fixing minor inaccuracies

ATTENTION! Starting with this version, system requirements have been INCREASED! (PHP not lower than 7.0, Main module not lower than 16.5.9).

YOU MUST MAKE A BACKUP BEFORE UPDATING!

— adjusted the default template design

— fixed errors that sometimes caused the "paid" status not to be set for the payment system

— fixed an error that could cause the payment flag to be lost

— added the ability to create multiple payments for a single order. Printing receipts on the Tinkoff side must be disabled (you need to set an empty value for VAT or Tax System in the PS settings), or a custom receipt handler must be added that sets the correct amount for each payment.

— added the "Automatic redirect to payment gateway" option, which removes the intermediate step with the "Pay" button and sends directly to the bank. Works in the default payment template;

— improved compatibility with the d7 core.

— added handling of reservation cancellation for two-stage payments. It is performed in the same way as handling a refund.

— added the ability to set the "paid" flag for orders with reserved payment in a two-stage payment.

— removed VAT 18% and 18/118, added 20% and 20/120

Fixed errors occurring when printing a receipt if the order did not have an email or phone property.

— added the afterBuildReceipt event, allowing modification of data sent for receipt generation. The order object is passed as the first parameter to the event handler, and the generated receipt data array as the second

Added the ability to choose where to send the receipt to the buyer: only via email, only via phone, or to both simultaneously

Products with a zero price are excluded from the receipt sent to Tinkoff

— added setting the payment number in the payment document in the "Payment document number" field

— minor fixes

Added the ability to choose the status of paid orders

— selection of order statuses for which a refund was made

— ability to cancel orders for which a refund was made

— fix for the display error of automatic delivery services

Multi-site support: setting up payment handlers for selected sites

The length of product and delivery service names in the receipt is limited to 64 characters.

Additional validation has been added when adding automated delivery services to the receipt.

Spelling errors have been corrected.

Dependency checks have been added during installation and payment.

The ability to print receipts via third-party services has been added. To do this, with the "Allow printing receipts" checkbox enabled, set an empty value for VAT or Taxation System in the PS settings.

The ability to select the status into which authorized orders will be moved during a two-stage payment has been added.

Forced overwriting of notification reception files has been added during installation/reinstallation.

Error output during installation/removal has been fixed.

The duplicate setting for printing receipts has been removed. Now receipts are enabled via the standard "Allow printing receipts" checkbox.

- Added the ability to pass cart contents for receipt printing (this feature must be enabled in the payment handler, and the taxation system and VAT mode must be configured).

- Added support for two-stage authorization with confirmation from the bank's personal account.

- Connection to the bank via a new protocol version.

Added verification and creation of necessary directories during installation

Fixed installation error with expired demo period