• Бизнесу
  • Решения
  • Тарифы
  • Справка и поддержка
  • 54-ФЗ

Разработчикам

Выберите удобный способ подключения и ознакомьтесь с документацией. После интеграции проведите тестовый платёж.

Разработчикам

  • ПЛАТЁЖНЫЙ ВИДЖЕТ
  • МОДУЛИ CMS
  • МОБИЛЬНЫЙ SDK
  • ДОКУМЕНТАЦИЯ, API
  • НОТИФИКАЦИИ
  • ТЕСТОВЫЕ ПЛАТЕЖИ
  • APPLE PAY
Платёжный виджет
Установка
Настройка
Формирование чеков
Остальные возможности
Платёжный виджет
1
Установите платёжный виджет
Вставьте код на ваш сайт в место, где должна располагаться кнопка "Оплатить".
Показать пример кода
<style>.tinkoffPayRow{display:block;margin:1%;width:160px;}</style>
<script src="https://securepay.tinkoff.ru/html/payForm/js/tinkoff_v2.js"></script>
<form name="TinkoffPayForm" onsubmit="pay(this); return false;">
	<input class="tinkoffPayRow" type="hidden" name="terminalkey" value="TinkoffBankTest">
	<input class="tinkoffPayRow" type="hidden" name="frame" value="true">
	<input class="tinkoffPayRow" type="hidden" name="language" value="ru">
    <input class="tinkoffPayRow" type="text" placeholder="Сумма заказа" name="amount" required>
    <input class="tinkoffPayRow" type="text" placeholder="Номер заказа" name="order">
    <input class="tinkoffPayRow" type="text" placeholder="Описание заказа" name="description">
    <input class="tinkoffPayRow" type="text" placeholder="ФИО плательщика" name="name">
    <input class="tinkoffPayRow" type="text" placeholder="E-mail" name="email">
    <input class="tinkoffPayRow" type="text" placeholder="Контактный телефон" name="phone">
    <input class="tinkoffPayRow" type="submit" value="Оплатить">
</form>
2
Настройте платёжный виджет
Вставьте идентификатор магазина в код платёжного виджета в параметр terminalkey. Идентификатор магазина выдаётся Банком. Его можно получить в Личном кабинете (раздел "Магазины").
Показать пример кода
<input class="tinkoffPayRow" type="hidden" name="terminalkey" value="Идентификатор магазина">
Если необходимо открывать платёжную форму в новом окне, выставьте у поля frame значение value в false.
Показать пример кода
<input class="tinkoffPayRow" type="hidden" name="frame" value="false">
Если необходимо изменить язык платёжной формы на английский, выставьте у поля language значение value в en.
Показать пример кода
<input class="tinkoffPayRow" type="hidden" name="language" value="en">
Если необходимо изменить состав полей платежного виджета, укажите у полей, которые хотите скрыть, type="hidden".
Показать пример кода
<input class="tinkoffPayRow" type="hidden" placeholder="ФИО плательщика" name="name">
Если необходимо сделать обязательным для заполнения какое-либо поле, выставьте у этого поля параметр required.
Показать пример кода
<input class="tinkoffPayRow" type="text" placeholder="E-mail" name="email" required>
Стилизация платежного виджета производится магазином самостоятельно. Ограничений на стилизацию со стороны Тинькофф Банка нет.
3
Настройте передачу дополнительных атрибутов для формирования чека
Добавьте в код платежного виджета дополнительный параметр "receipt".
Показать пример кода
<input class="tinkoffPayRow" type="hidden" name="receipt" value="">
В поле "value" параметра receipt укажите данные чека. Пример:
Показать пример кода
<input class="tinkoffPayRow" type="hidden" name="receipt" value='{"Email": "a@test.ru",
"Phone": "+79031234567","Taxation": "osn","Items": [ {"Name": "Наименование товара 1",
"Price": 10000,"Quantity": 1.00,"Amount": 10000,"Tax": "vat10","Ean13": "0123456789" },
{"Name": "Наименование товара 2","Price": 20000,"Quantity": 2.00,"Amount": 40000,
"Tax": "vat18"},{"Name": "Наименование товара 3","Price": 30000,"Quantity": 3.00,
"Amount": 90000,"Tax": "vat10"}]}'>
Структура Receipt
Наименование
Обязательный
Описание
Наименование
Items
Обязательный
Да
Описание
Массив, содержащий в себе позиции чека с информацией о товарах
Наименование
Email
Обязательный
Нет*
Описание
Электронная почта. Максимальная длина строки – 64 символа
Наименование
Phone
Обязательный
Нет*
Описание
Телефон. Максимальная длина строки – 64 символа
Наименование
Taxation
Обязательный
Да
Описание
Система налогообложения. Перечисление со значениями:
  • «osn» – общая СН;
  • «usn_income» – упрощенная СН (доходы);
  • «usn_income_outcome» – упрощенная СН (доходы минус расходы);
  • «envd» – единый налог на вмененный доход;
  • «esn» – единый сельскохозяйственный налог;
  • «patent» – патентная СН
*В параметр receipt для "Email" и "Phone" подставляются значения, указанные в полях ввода платежного виджета:
Показать пример кода
<input class="tinkoffPayRow" type="text" placeholder="E-mail" name="email">
<input class="tinkoffPayRow" type="text" placeholder="Контактный телефон" name="phone">
В receipt параметр "E-mail" или "Phone" должен быть заполнен. Если оба параметра пустые – отображается сообщение об ошибке: "Поле E-mail или Phone не должно быть пустым."
Структура объекта Items
Наименование
Обязательный
Описание
Наименование
Name
Обязательный
Да
Описание
Наименование товара. Максимальная длина строки – 64 символа
Наименование
Price
Обязательный
Да
Описание
Цена в копейках.
Целочисленное значение не более 10 знаков
Наименование
Quantity
Обязательный
Да
Описание
Количество/вес:
  • целая часть не более 8 знаков;
  • дробная часть не более 3 знаков
Наименование
Amount
Обязательный
Да
Описание
Сумма в копейках.
Целочисленное значение не более 10 знаков
Наименование
Tax
Обязательный
Да
Описание
Ставка налога.
Перечисление со значениями:
  • «none» – без НДС;
  • «vat0» – НДС по ставке 0%;
  • «vat10» – НДС чека по ставке 10%;
  • «vat18» – НДС чека по ставке 18%;
  • «vat110» – НДС чека по расчетной ставке 10/110;
  • «vat118» – НДС чека по расчетной ставке 18/118
В Items значение параметра Amount рекомендуется проверять на соответствие значению Price * Quantity.
Параметр Amount в поле ввода платежного Виджета должен быть равен сумме значений параметра Amount объектов Items:
Показать пример кода
<input class="tinkoffPayRow" type="text" placeholder="Сумма заказа" name="amount">
Массив Items должен быть меньше или равен 99.
Остальные возможности
Если вы хотите использовать расширенные возможности и управлять платежом, используйте API

Время принимать оплату в интернете

Заполните заявку - мы рассмотрим её за 2 рабочих дня
Имя и Фамилия*
Введите Ваше Имя и Фамилию
Это поле обязательно
ИНН организации или ИП*
Введите корректный ИНН
Это поле обязательно
Номер мобильного телефона*
Введите корректный номер
Это поле обязательно
Электронная почта*
Введите корректный Email
Это поле обязательно
Комментарий
Укажите, пожалуйста, сайт магазина, планируемый объем платежей и другую информацию, которую считаете важной. Также отметьте, если вы планируете принимать оплату на сайте за услуги ЖКХ, МФО, госуслуги или продажи авиабилетов.
Для продолжения нужно согласие с условиями
Возникла ошибка
В ходе отправки данных формы возникла ошибка.
Регистрация пройдена
Логин и пароль для доступа в личный кабинет высланы вам в SMS сообщении, войдите в личный кабинет для продолжения оформления заявки на подключение интернет-магазина.
Регистрация заявки
Секундочку, мы проверяем данные и создаём заявку.
Подтвердите мобильный телефон
Код отправлен вам на номер
Код подтверждения*
Некорректный код подтверждения
Это поле обязательно
Некорректный код подтверждения
Запросить код повторно можно через 60 сек
Отправить код повторно
|
SMS не приходит
Возможные причины проблемы
  • Вы ввели не свой номер телефона, ошиблись в номере. Вернитесь обратно и введите правильный номер;
  • Проблемы могут быть со стороны сотового оператора. (недоступна сеть, запрет на входящие SMS и так далее). Обратитесь в службу поддержки своего оператора;
  • Проблема с телефоном (отсутствует связь, телефон не может принимать SMS и прочее). Обратитесь в службу поддержки своего оператора;