Обновлено 08.12.2023
После установки модуля, компонент «Платежная форма Tinkoff Bank (без интрнет-магазина)» (rover:tinkoff.payform) будет доступен в визуальном редакторе по адресу «Компоненты Rover» > «Интернет-эквайринг Тинькофф приём платежей».
Компонент может выводить:
Компонент необходимо устанавливать туда, где по логике вещей сайта располагаться переход к оплате.
TERMINAL_ID
— идентификатор платежного терминала Tinkoff BankSHOP_SECRET_WORD
— пароль платежного терминала Tinkoff BankSUM
— сумма заказа в рубляхORDER_ID
— идентификатор заказа
ITEM_ID
— идентификатор платежа. Помогает различать платежи внутри одного заказа в банке. Если не задан, то вместо него берется текущая временная метка.
PS_MODE
— способ приёма оплаты: платежный шлюз банка ('DEFAULT'
), платежный виджет на странице ('WIDGET'
), QR-код ('SKB'
). По умолчанию 'DEFAULT'
.
PAYMENT_DESCRIPTION
— описание платежа для банка
REDIRECT_LIFETIME
— время жизни ссылки оплаты в часах, по умолчанию 24
SUM_FORMATTED
— форматированная сумма с обозначением валюты. Если передана, будет выведена в форме оплаты, если не передана, будет применено стандартное форматирование для поля SUM
SUM_IN_CURRENCY_FORMATTED
— форматированная сумма в валюте, отличной от рубля. Если передана, будет выведена в форме оплаты вместе с суммой в рублях. Оплата в любом случае будет в рублях, из поля SUM
.
NOTIFICATION_URL
— адрес для нотификаций
SUCCESS_URL
— перенаправление после успешного платежа
FAIL_URL
— перенаправление после неуспешного платежа
FORM_DESCRIPTION
— описание в форме оплаты
SUM_DESCRIPTION
— описание перед суммой оплаты
BUTTON_TEXT
— текст на кнопке оплатыBUTTON_CLASSES
— классы кнопки оплатыBOTTOM_DESCRIPTION
— описание под кнопкой оплатыQR_BOTTOM_DESCRIPTION
— дополнительное описание под кнопкой оплаты для оплаты по QR-кодуERROR_NOTE
— переопределение дефолтного сообщения о недоступности сервиса оплатыMESSAGE
— дополнительное сообщение об ошибкеREDIRECT
— автоматическое перенаправление на платежный шлюз/открытие виджета
REDIRECT_DELAY
— задержка перед перенаправлением в миллисекундах
LANGUAGE
— язык платёжной формы. По умолчанию 'ru'
Итоговый идентификатор платежа в Тинькофф Банке формируется как "#идентификатор заказа#_#идентификатор платежа#". Он быть уникальным для каждой оплаты! Создать вторую оплату с тем же идентификатором банк не даст, будет выведена ошибка.
В связи с тем, что использование данного компонента предполагает отсутствие модуля «Интернет-магазин», то штатный механизм обработки нотификаций тут не предусмотрен. Для удобства добавлено специальное событие onNotification
, которое срабатывает при получении нотификации в файл https://#ваш домен#/bitrix/components/rover/tinkoff.payform/result.php
. Для использования данного механизма необходимо:
https://#ваш домен#/bitrix/components/rover/tinkoff.payform/result.php
(для оплаты по QR-коду — только в настройках терминала) init.php
обработчик события onNotification
. В этом обработчике в параметре request
будет приходить вся информация из отправленных банком оповещений. Пример обработчика