{toc:maxLevel=3}
h2. Заключите договор с Тинькофф и настройте ссылку на биллинг в их личном кабинете
# Заключите договор с платежной системой Тинькофф
# Выполните настройки подключения, которые производятся через *главную страницу веб-интерфейса администратора* \-> *Платежные системы*.
# На странице https://oplata.tinkoff.ru/landing/develop/notifications включите опцию "Нотификация по HTTP"
# На стороне платежной системы укажите callback адрес:
{code:title=Пример адреса callback}http://10.0.0.1/tinkoff.php{code}
IP-адрес _10.0.0.1_ замените на публичный адрес Вашего сервера биллинга и настройте правила firewall, как указано ниже
h2. Настройте биллинг
h3. Добавьте адреса Тинькоф в список разрешенных
- Для приема платежей со стороны платежной системы необходимо добавить IP-адреса, с которых осуществляется запрос в список разрешенных по статье "[CarbonBilling:Настройка сети для платежных систем]"
h3. Добавьте правила фаервола
Добавьте правила фаервола по статье "[CarbonBilling:Дополнительные настройки. hooks. Хуки. Свои правила в firewall]", так как Тинькофф может обращаться только на порт 443.
В приведенных правилах подсеть 91.194.226.0/23 относится к сети платежной сети Тинькофф, однако она может меняться. Перед добавлением правил уточните актуальные адреса платежной системы у её представителей.
Файл */app/asr_cabinet/cfg/hooks*
{code}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{code}
Файл */app/asr_fiscal/cfg/hooks*
{code}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 {code}
h3. Укажите параметры интеграции с Тинькофф
!tinkoff_settings_cb5.png|border=0,width=800!
h4. Общие опции
* *Ключ терминала* - ключ терминала (TerminalKey), его необходимо запросить у Тинькофф
* *Секретный ключ* - секретный ключ (Password), его необходимо запросить у Тинькофф
h4. Опции при интеграции с онлай-кассой Тинькофф для отправки чеков по ФЗ-54
* *Отправлять данные фискального чека* - включить отправку данных для чека _(Если данную опцию включить при одновременном использовании с АТОЛ Онлайн, то чеки через АТОЛ передаваться не будут)_
* *Налоговая ставка в ККТ* - Tax в [документации Тинькофф|https://oplata.tinkoff.ru/develop/api/payments/init-request/]
** none — без НДС
** vat0 — 0%
** vat10 — 10%
** vat20 — 20%
** vat110 — 10/110
** vat120 — 20/120
* *Признак способа расчёта* - PaymentMethod в [документации Тинькофф|https://oplata.tinkoff.ru/develop/api/payments/init-request/]
** full_payment — полный расчет
** full_prepayment — предоплата 100%
** prepayment — предоплата
** advance — аванс
** partial_payment — частичный расчет и кредит
** credit — передача в кредит
** credit_payment — оплата кредита
* *Признак предмета расчёта* - PaymentObject в [документации Тинькофф|https://oplata.tinkoff.ru/develop/api/payments/init-request/]
** commodity — товар
** excise — подакцизный товар
** job — работа
** service — услуга
** gambling_bet — ставка азартной игры
** gambling_prize — выигрыш азартной игры
** lottery — лотерейный билет
** lottery_prize — выигрыш лотереи
** intellectual_activity — предоставление результатов интеллектуальной деятельности
** payment — платежagent_commission — агентское вознаграждение
** composite — составной предмет расчета
** another — иной предмет расчета
* *Система налогообложения* - Taxation в [документации Тинькофф|https://oplata.tinkoff.ru/develop/api/payments/init-request/]
** osn — общая
** usn_income — упрощенная (доходы)
** usn_income_outcome — упрощенная (доходы минус расходы)
** patent — патентная
** envd — единый налог на вмененный доход
** esn — единый сельскохозяйственный налог
h2. Настройте оплату через личный кабинет
Добавить на страницу оплаты шорткод для _Tinkoff_ [CarbonBilling:Отображение платежных систем в личном кабинете абонента]
h2. Особенности
Если возникли изменения ip-адресов со стороны платежной системы(ПС), а в биллинге актуальные адреса не были добавлены в список "Разрешенных", то платежи, поступившие после смены ip на стороне ПС будут считаться как _PAY_(оплачено).
В биллинг информация о платежах не сможет поступить, выполнить повторную отправку информации по платежам ПС не имеет возможности, все приходы потребуется заносить в биллинге вручную.
h2. Заключите договор с Тинькофф и настройте ссылку на биллинг в их личном кабинете
# Заключите договор с платежной системой Тинькофф
# Выполните настройки подключения, которые производятся через *главную страницу веб-интерфейса администратора* \-> *Платежные системы*.
# На странице https://oplata.tinkoff.ru/landing/develop/notifications включите опцию "Нотификация по HTTP"
# На стороне платежной системы укажите callback адрес:
{code:title=Пример адреса callback}http://10.0.0.1/tinkoff.php{code}
IP-адрес _10.0.0.1_ замените на публичный адрес Вашего сервера биллинга и настройте правила firewall, как указано ниже
h2. Настройте биллинг
h3. Добавьте адреса Тинькоф в список разрешенных
- Для приема платежей со стороны платежной системы необходимо добавить IP-адреса, с которых осуществляется запрос в список разрешенных по статье "[CarbonBilling:Настройка сети для платежных систем]"
h3. Добавьте правила фаервола
Добавьте правила фаервола по статье "[CarbonBilling:Дополнительные настройки. hooks. Хуки. Свои правила в firewall]", так как Тинькофф может обращаться только на порт 443.
В приведенных правилах подсеть 91.194.226.0/23 относится к сети платежной сети Тинькофф, однако она может меняться. Перед добавлением правил уточните актуальные адреса платежной системы у её представителей.
Файл */app/asr_cabinet/cfg/hooks*
{code}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{code}
Файл */app/asr_fiscal/cfg/hooks*
{code}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 {code}
h3. Укажите параметры интеграции с Тинькофф
!tinkoff_settings_cb5.png|border=0,width=800!
h4. Общие опции
* *Ключ терминала* - ключ терминала (TerminalKey), его необходимо запросить у Тинькофф
* *Секретный ключ* - секретный ключ (Password), его необходимо запросить у Тинькофф
h4. Опции при интеграции с онлай-кассой Тинькофф для отправки чеков по ФЗ-54
* *Отправлять данные фискального чека* - включить отправку данных для чека _(Если данную опцию включить при одновременном использовании с АТОЛ Онлайн, то чеки через АТОЛ передаваться не будут)_
* *Налоговая ставка в ККТ* - Tax в [документации Тинькофф|https://oplata.tinkoff.ru/develop/api/payments/init-request/]
** none — без НДС
** vat0 — 0%
** vat10 — 10%
** vat20 — 20%
** vat110 — 10/110
** vat120 — 20/120
* *Признак способа расчёта* - PaymentMethod в [документации Тинькофф|https://oplata.tinkoff.ru/develop/api/payments/init-request/]
** full_payment — полный расчет
** full_prepayment — предоплата 100%
** prepayment — предоплата
** advance — аванс
** partial_payment — частичный расчет и кредит
** credit — передача в кредит
** credit_payment — оплата кредита
* *Признак предмета расчёта* - PaymentObject в [документации Тинькофф|https://oplata.tinkoff.ru/develop/api/payments/init-request/]
** commodity — товар
** excise — подакцизный товар
** job — работа
** service — услуга
** gambling_bet — ставка азартной игры
** gambling_prize — выигрыш азартной игры
** lottery — лотерейный билет
** lottery_prize — выигрыш лотереи
** intellectual_activity — предоставление результатов интеллектуальной деятельности
** payment — платежagent_commission — агентское вознаграждение
** composite — составной предмет расчета
** another — иной предмет расчета
* *Система налогообложения* - Taxation в [документации Тинькофф|https://oplata.tinkoff.ru/develop/api/payments/init-request/]
** osn — общая
** usn_income — упрощенная (доходы)
** usn_income_outcome — упрощенная (доходы минус расходы)
** patent — патентная
** envd — единый налог на вмененный доход
** esn — единый сельскохозяйственный налог
h2. Настройте оплату через личный кабинет
Добавить на страницу оплаты шорткод для _Tinkoff_ [CarbonBilling:Отображение платежных систем в личном кабинете абонента]
h2. Особенности
Если возникли изменения ip-адресов со стороны платежной системы(ПС), а в биллинге актуальные адреса не были добавлены в список "Разрешенных", то платежи, поступившие после смены ip на стороне ПС будут считаться как _PAY_(оплачено).
В биллинг информация о платежах не сможет поступить, выполнить повторную отправку информации по платежам ПС не имеет возможности, все приходы потребуется заносить в биллинге вручную.