Заключите договор с Тинькофф и настройте ссылку на биллинг в их личном кабинете
- Заключите договор с платежной системой Тинькофф
- Выполните настройки подключения, которые производятся через главную страницу веб-интерфейса администратора -> Платежные системы.
- На странице https://oplata.tinkoff.ru/landing/develop/notifications включите опцию "Нотификация по HTTP"
- На стороне платежной системы укажите callback адрес:
Пример адреса callback
http://10.0.0.1/tinkoff.php
IP-адрес 10.0.0.1 замените на публичный адрес Вашего сервера биллинга и настройте правила firewall, как указано ниже
Настройте биллинг
Добавьте адреса Тинькоф в список разрешенных
- Для приема платежей со стороны платежной системы необходимо добавить IP-адреса, с которых осуществляется запрос в список разрешенных по статье "Настройка сети для платежных систем"
Добавьте правила фаервола
Добавьте правила фаервола по статье "Дополнительные настройки. hooks. Хуки. Свои правила в firewall", так как Тинькофф может обращаться только на порт 443.
В приведенных правилах подсеть 91.194.226.0/23 относится к сети платежной сети Тинькофф, однако она может меняться. Перед добавлением правил уточните актуальные адреса платежной системы у её представителей.
Файл /app/asr_cabinet/cfg/hooks
if [ "$1" == "/etc/init.d/firewall" -a "$2" == "start" ]; then source /cfg/config echo "=========================================" set +x iptables -t nat -I asr_cabinet_prerouting -p tcp -m tcp -s 91.194.226.0/23 --dport 80 -m addrtype --dst-type LOCAL -j DNAT --to-destination 169.254.14.44:1444 iptables -t nat -I asr_cabinet_prerouting -s 91.194.226.0/23 -p tcp -m tcp --dport 443 -m addrtype --dst-type LOCAL -j DNAT --to-destination 169.254.14.43:2443 set +x fi
Файл /app/asr_fiscal/cfg/hooks
if [ "$1" == "/etc/init.d/firewall" -a "$2" == "start" ]; then source /cfg/config echo "=========================================" set -x iptables -t nat -I asr_fiscal_prerouting -p tcp -m tcp -s 91.194.226.0/23 --dport 80 -m addrtype --dst-type LOCAL -j DNAT --to-destination 169.254.14.44:${app[apache.port]} iptables -t nat -I asr_fiscal_prerouting -s 91.194.226.0/23 -p tcp -m tcp --dport 443 -m addrtype --dst-type LOCAL -j DNAT --to-destination 169.254.14.43:${app[apache.sslport2]} set +x fi
Укажите параметры интеграции с Тинькофф
Общие опции
- Ключ терминала - ключ терминала (TerminalKey), его необходимо запросить у Тинькофф
- Секретный ключ - секретный ключ (Password), его необходимо запросить у Тинькофф
Опции при интеграции с онлай-кассой Тинькофф для отправки чеков по ФЗ-54
- Отправлять данные фискального чека - включить отправку данных для чека (Если данную опцию включить при одновременном использовании с АТОЛ Онлайн, то чеки через АТОЛ передаваться не будут)
- Налоговая ставка в ККТ - Tax в документации Тинькофф
- none — без НДС
- vat0 — 0%
- vat10 — 10%
- vat20 — 20%
- vat110 — 10/110
- vat120 — 20/120
- Признак способа расчёта - PaymentMethod в документации Тинькофф
- full_payment — полный расчет
- full_prepayment — предоплата 100%
- prepayment — предоплата
- advance — аванс
- partial_payment — частичный расчет и кредит
- credit — передача в кредит
- credit_payment — оплата кредита
- Признак предмета расчёта - PaymentObject в документации Тинькофф
- commodity — товар
- excise — подакцизный товар
- job — работа
- service — услуга
- gambling_bet — ставка азартной игры
- gambling_prize — выигрыш азартной игры
- lottery — лотерейный билет
- lottery_prize — выигрыш лотереи
- intellectual_activity — предоставление результатов интеллектуальной деятельности
- payment — платежagent_commission — агентское вознаграждение
- composite — составной предмет расчета
- another — иной предмет расчета
- Система налогообложения - Taxation в документации Тинькофф
- osn — общая
- usn_income — упрощенная (доходы)
- usn_income_outcome — упрощенная (доходы минус расходы)
- patent — патентная
- envd — единый налог на вмененный доход
- esn — единый сельскохозяйственный налог
Настройте оплату через личный кабинет
Добавить на страницу оплаты шорткод для Tinkoff Отображение платежных систем в личном кабинете абонента
Особенности
Если возникли изменения ip-адресов со стороны платежной системы(ПС), а в биллинге актуальные адреса не были добавлены в список "Разрешенных", то платежи, поступившие после смены ip на стороне ПС будут считаться как PAY(оплачено).
В биллинг информация о платежах не сможет поступить, выполнить повторную отправку информации по платежам ПС не имеет возможности, все приходы потребуется заносить в биллинге вручную.