Payment.tinkoff repository from ASDAFF
Модуль позволяет подключить эквайринг Tinkoff bank к интернет-магазину на 1С Битрикс и принимать платежи по банковским картам (Visa, MasterCard, Мир), через интернет-банк Tinkoff.ru, Apple Pay и Google Pay из любых стран.
Возможности
✔ Автоматическая установка флага «Оплачено» при прохождении оплаты (если флаг не устанавливается, проверьте настройки на вкладке «Автоматизация процессов» модуля «Интернет-магазин» или настройки других сторонних модулей, связанных с обработкой заказа или оплаты).
✔ Возврат денежных средств на карту покупателя штатными средствами интернет-магазина Bitrix.
*возможность отмены такого заказа.
✔ Корректная работа с буквенно-цифровыми номерами заказов (например, 6B7R1, 8CB2A59X8X).
✔ Передача информации для печати чеков (54-ФЗ):
- через Банк Тинькофф (в обработчике платежей необходимо указать систему налогообложения и режим НДС);
- корректная передача названий автоматизированных служб доставки;
- если необходимо использовать сторонний сервис, то в настройках ПС оставьте галочку «Разрешить печать чеков», а в полях «НДС» или «Системы налогообложения установите» пустое значение, так чеки в Тинькофф отправляться не будут.
- поддержка двухстадийного платежа с подтверждением через личный кабинет банка;
- выбор статуса, в который будут переводиться авторизованные заказы при двухстадийном платеже;
- возможность установить флаг оплаты для авторизованных заказов.
✔ Многосайтовость: установка обработчиков платежей на выбранные сайты.
✔ Кастомизация кнопки, отправляющей на платежный шлюз банка.
✔ Автоматическое перенаправление на платежный шлюз сразу после оформления заказа.
Настройки платежной системы в Битрикс
После установки модуля, в Битрикс появится новая платежная система. Ее необходимо включить и настроить.
- Зайти в административную часть интернет-магазина.
- Перейти на страницу Магазин → Настройки → Платежные системы.
- Нажать кнопку «Добавить платежную систему».
- Во вкладке «Платежная система» выбрать «Тинькофф банк (payment_tinkoff)» в поле «Обработчик».
- Ввести заголовок, название, описание и сортировку платежной системы, и сделать ее активной.
- Выбрать «Эквайринговая операция» в поле «Тип оплаты», выбрать кодировку модуля в поле «Кодировка»
- Снять все чекбоксы «по умолчанию» на вкладке «По умолчанию». Внимание! На вкладке «Физическое лицо» у всех параметров должны быть выставлены чекбоксы «По умолчанию».
- Заполнить форму платежной системы, руководствуясь подсказками к полям. Внимание! В поле «Сумма к оплате» обработчика платежа необходимо выбрать «Оплата» → «Цена». Настройка «Заказ» → «Стоимость заказа» не работает!
- Нажать «Сохранить».
Для корректной работы модуля директива allow_url_fopen в php.ini должна быть включена ( allow_url_fopen = On ), а также с Вашего сервера должен быть доступ к securepay.tinkoff.ru по порту 443.
Проверить можно с помощью команды: telnet securepay.tinkoff.ru 443.
Если ресурс недоступен, необходимо связаться с Вашим хостинг-провайдером и попросить открыть ресурс для отправки запросов.
Настройки платежного терминала Тинькофф Банк:
- Включить нотификации по протоколу HTTP на ссылку для уведомлений вида — http(s)://домен_вашего_сайта/personal/order/notification.php
- (опционально) поставить свои страницы успеха и ошибки вида http(s)://домен_вашего_сайта/personal/order/success.php и http(s)://домен_вашего_сайта/personal/order/failed.php соответственно.
Если ваш сайт работает по http, то и в настройках со стороны Тинькофф должен стоять http. Аналогично c https. Иначе работа нотификаций не гарантируется!
Настройка интеграции с онлайн-кассами
В настройках платежной системы необходимо:
- Выбрать систему налогообложения магазина в раскрывающемся меню «Система налогообложения»
- Выбрать необходимую ставку налога для доставки для передачи в чек в списке «НДС».
- Если не указана «Система налогообложения» или «НДС», информация для печати чека передана не будет!
- Доставка добавляется в чек отдельной позицией!
Внимание! Для корректной передачи данных чека в онлайн-кассу необходимо: выставить для всех товаров магазина корректную ставку НДС; указать в настройках модуля систему налогообложения и ставку налога для доставки.
Кастомизация шаблона кнопки
Кастомизация шаблона кнопки, ведущей на форму оплаты банка, приводится стандартным способом. Подробнее об этом в обучающем курсе: https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=43&LESSON_ID=8485. Имя платежной системы — payment_tinkoff.
Пример кастомизации данных, передаваемых для печати чека
Заменяем все позиции на одну общую.
$eventManager = \Bitrix\Main\EventManager::getInstance(); $eventManager->addEventHandler('payment.tinkoff', 'afterBuildReceipt', array('PaymentTinkoffReceipt', 'fix')); class PaymentTinkoffReceipt < /** * @param \Bitrix\Main\Event $event * @return \Bitrix\Main\EventResult */ function fix(Bitrix\Main\Event $event) < /** @var \Bitrix\Sale\Order $order */ $parameters = $event->getParameters(); $order = $parameters[0]; $fields = $parameters[1]; $items = $fields['Items']; $fields['Items'] = [ [ 'Name' => 'Гайки и болты', 'Price' => $order->getPrice() * 100, 'Quantity' => 1, 'Amount' => $order->getPrice() * 100, 'Tax' => $items[0]['Tax'] ] ]; $parameters[1] = $fields; return new Bitrix\Main\EventResult(Bitrix\Main\EventResult::SUCCESS, $parameters, 'payment.tinkoff'); > >
расширение php-curl «Главный модуль» Bitrix 16.5.9 и выше (на более низких работать не будет) php 7.0 или выше.
Saved searches
Use saved searches to filter your results more quickly
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
ASDAFF/payment.tinkoff
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
Git stats
Files
Failed to load latest commit information.
README.md
Модуль позволяет подключить эквайринг Tinkoff bank к интернет-магазину на 1С Битрикс и принимать платежи по банковским картам (Visa, MasterCard, Мир), через интернет-банк Tinkoff.ru, Apple Pay и Google Pay из любых стран.
Возможности
✔ Автоматическая установка флага «Оплачено» при прохождении оплаты (если флаг не устанавливается, проверьте настройки на вкладке «Автоматизация процессов» модуля «Интернет-магазин» или настройки других сторонних модулей, связанных с обработкой заказа или оплаты).
✔ Возврат денежных средств на карту покупателя штатными средствами интернет-магазина Bitrix.
*возможность отмены такого заказа.
✔ Корректная работа с буквенно-цифровыми номерами заказов (например, 6B7R1, 8CB2A59X8X).
✔ Передача информации для печати чеков (54-ФЗ):
- через Банк Тинькофф (в обработчике платежей необходимо указать систему налогообложения и режим НДС);
- корректная передача названий автоматизированных служб доставки;
- если необходимо использовать сторонний сервис, то в настройках ПС оставьте галочку «Разрешить печать чеков», а в полях «НДС» или «Системы налогообложения установите» пустое значение, так чеки в Тинькофф отправляться не будут.
- поддержка двухстадийного платежа с подтверждением через личный кабинет банка;
- выбор статуса, в который будут переводиться авторизованные заказы при двухстадийном платеже;
- возможность установить флаг оплаты для авторизованных заказов.
✔ Многосайтовость: установка обработчиков платежей на выбранные сайты.
✔ Кастомизация кнопки, отправляющей на платежный шлюз банка.
✔ Автоматическое перенаправление на платежный шлюз сразу после оформления заказа.
Настройки платежной системы в Битрикс
После установки модуля, в Битрикс появится новая платежная система. Ее необходимо включить и настроить.
- Зайти в административную часть интернет-магазина.
- Перейти на страницу Магазин → Настройки → Платежные системы.
- Нажать кнопку «Добавить платежную систему».
- Во вкладке «Платежная система» выбрать «Тинькофф банк (payment_tinkoff)» в поле «Обработчик».
- Ввести заголовок, название, описание и сортировку платежной системы, и сделать ее активной.
- Выбрать «Эквайринговая операция» в поле «Тип оплаты», выбрать кодировку модуля в поле «Кодировка»
- Снять все чекбоксы «по умолчанию» на вкладке «По умолчанию». Внимание! На вкладке «Физическое лицо» у всех параметров должны быть выставлены чекбоксы «По умолчанию».
- Заполнить форму платежной системы, руководствуясь подсказками к полям. Внимание! В поле «Сумма к оплате» обработчика платежа необходимо выбрать «Оплата» → «Цена». Настройка «Заказ» → «Стоимость заказа» не работает!
- Нажать «Сохранить».
Для корректной работы модуля директива allow_url_fopen в php.ini должна быть включена ( allow_url_fopen = On ), а также с Вашего сервера должен быть доступ к securepay.tinkoff.ru по порту 443.
Проверить можно с помощью команды: telnet securepay.tinkoff.ru 443.
Если ресурс недоступен, необходимо связаться с Вашим хостинг-провайдером и попросить открыть ресурс для отправки запросов.
Настройки платежного терминала Тинькофф Банк:
- Включить нотификации по протоколу HTTP на ссылку для уведомлений вида — http(s)://домен_вашего_сайта/personal/order/notification.php
- (опционально) поставить свои страницы успеха и ошибки вида http(s)://домен_вашего_сайта/personal/order/success.php и http(s)://домен_вашего_сайта/personal/order/failed.php соответственно.
Если ваш сайт работает по http, то и в настройках со стороны Тинькофф должен стоять http. Аналогично c https. Иначе работа нотификаций не гарантируется!
Настройка интеграции с онлайн-кассами
В настройках платежной системы необходимо:
- Выбрать систему налогообложения магазина в раскрывающемся меню «Система налогообложения»
- Выбрать необходимую ставку налога для доставки для передачи в чек в списке «НДС».
- Если не указана «Система налогообложения» или «НДС», информация для печати чека передана не будет!
- Доставка добавляется в чек отдельной позицией!
Внимание! Для корректной передачи данных чека в онлайн-кассу необходимо: выставить для всех товаров магазина корректную ставку НДС; указать в настройках модуля систему налогообложения и ставку налога для доставки.
Кастомизация шаблона кнопки
Кастомизация шаблона кнопки, ведущей на форму оплаты банка, приводится стандартным способом. Подробнее об этом в обучающем курсе: https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=43&LESSON_ID=8485. Имя платежной системы — payment_tinkoff.
Пример кастомизации данных, передаваемых для печати чека
Заменяем все позиции на одну общую.
$eventManager = \Bitrix\Main\EventManager::getInstance(); $eventManager->addEventHandler('payment.tinkoff', 'afterBuildReceipt', array('PaymentTinkoffReceipt', 'fix')); class PaymentTinkoffReceipt < /** * @param \Bitrix\Main\Event $event * @return \Bitrix\Main\EventResult */ function fix(Bitrix\Main\Event $event) < /** @var \Bitrix\Sale\Order $order */ $parameters = $event->getParameters(); $order = $parameters[0]; $fields = $parameters[1]; $items = $fields['Items']; $fields['Items'] = [ [ 'Name' => 'Гайки и болты', 'Price' => $order->getPrice() * 100, 'Quantity' => 1, 'Amount' => $order->getPrice() * 100, 'Tax' => $items[0]['Tax'] ] ]; $parameters[1] = $fields; return new Bitrix\Main\EventResult(Bitrix\Main\EventResult::SUCCESS, $parameters, 'payment.tinkoff'); > >
расширение php-curl «Главный модуль» Bitrix 16.5.9 и выше (на более низких работать не будет) php 7.0 или выше.