После установки, компонент «Платежная форма Tinkoff Bank» (rover:tinkoff.payform) будет доступен в визуальном редакторе по адресу «Компоненты Rover» > «Интернет-эквайринг Тинькофф приём платежей».
Компонент может выводить:
кнопку "Оплатить", по нажатию на которую происходит переход на платежный шлюз Тинькофф;
кнопку "Оплатить", с открытием платежного виджета прямо на сайте;
QR-код для оплаты в системе быстрых платежей.
Компонент необходимо устанавливать туда, где по логике вещей должен располагаться переход к оплате.
В настройках компонента обязательно нужно указать идентификатор и пароль от терминала и сумму в рублях
Также желательно указать идентификатор товара и дополнительный идентификатор платежа. Итоговый идентификатор платежа в Тинькофф формируется как "#идентификатор товара#_#дополнительный идентификатор платежа#". Если не задан дополнительный идентификатор платежа, то вместо него берется текущая временная метка.
Остальные параметры опциональны. Они описаны в меню настройки компонента.
Итоговый идентификатор платежа должен быть уникальным для каждой оплаты! Создать вторую оплату с тем же идентификатором банк не даст, будет выведена ошибка.
В параметр RECEIPT
компонента можно передать массив для формирования чека. Структура массива аналогична структуре, описанной в официальной документации https://www.tinkoff.ru/kassa/develop/api/receipt/
Пример:
$APPLICATION->IncludeComponent(
"rover:tinkoff.payform",
".default",
[
...
"SUM" => 500,
"RECEIPT" => [
'Email' => '[email protected]',
'Phone' => '79999999999',
'Taxation' => 'usn_income',
'Items' => [
[
'Name' => 'Тестовый товар',
'Quantity' => 2,
'Amount' => 40000,
'Price' => 20000,
'Tax' => 'none',
'PaymentMethod' => 'full_payment',
'PaymentObject' => 'commodity',
],
[
'Name' => 'Тестовая доставка',
'Quantity' => 1,
'Amount' => 10000,
'Price' => 10000,
'Tax' => 'none',
'PaymentMethod' => 'full_payment',
'PaymentObject' => 'service',
],
]
],
...
], false);
Обратите внимание, что в параметреSUM
стоимость указывается в рублях, а вRECEIPT
— везде в копейках.
В качестве ссылки для уведомления установите https://#ваш домен#/bitrix/components/rover/tinkoff.payform/result.php
Добавьте в файл init.php
обработчик события onNotification
. В этом обработчике в параметре request
будет приходить вся информация из отправленных банком оповещений. Пример обработчика