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

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

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

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

  • ПЛАТЁЖНЫЙ ВИДЖЕТ
  • МОДУЛИ CMS
  • МОБИЛЬНЫЙ SDK
  • ДОКУМЕНТАЦИЯ, API
  • НОТИФИКАЦИИ
  • ТЕСТОВЫЕ ПЛАТЕЖИ
  • APPLE PAY
  • GOOGLE 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>
Стилизация платежного виджета производится магазином самостоятельно. Ограничений на стилизацию со стороны Тинькофф Банка нет.
Формирование чеков
Если вы хотите использовать онлайн-кассы, вам необходимо настроить передачу дополнительных атрибутов для формирования чека. Для этого:
Добавьте в код платежного виджета дополнительный параметр "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",
  "EmailCompany": "b@test.ru","Taxation": "osn","Items": [ {"Name": "Наименование товара 1","Price": 10000,"Quantity": 1.00,
  "Amount": 10000,"PaymentMethod": "full_prepayment","PaymentObject": "commodity","Tax": "vat10","Ean13": "0123456789" },
  {"Name": "Наименование товара 2","Price": 20000,"Quantity": 2.00,"Amount": 40000,"PaymentMethod": "prepayment",
  "PaymentObject": "service","Tax": "vat20"},{"Name": "Наименование товара 3","Price": 30000,"Quantity": 3.00,"Amount": 90000,
  "Tax": "vat10"}]}'>
Структура Receipt
Наименование
Обязательный
Описание
Наименование
Items
Обязательный
Да
Описание
Массив, содержащий в себе позиции чека с информацией о товарах
Наименование
Email
Обязательный
Нет*
Описание
Электронная почта. Максимальная длина строки – 64 символа
Наименование
Phone
Обязательный
Нет*
Описание
Телефон. Максимальная длина строки – 64 символа
Наименование
EmailCompany
Обязательный
Нет
Описание
Электронная почта отправителя чека. Максимальная длина строки – 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 знаков
Наименование
PaymentMethod
Обязательный
Нет
Описание
Признак способа расчёта. Если значение не передано, по умолчанию в онлайн-кассу передается признак способа расчёта "full_payment".
Возможные значения:
  • full_prepayment – предоплата 100%.
  • prepayment – предоплата.
  • advance – аванс.
  • full_payment – полный расчет.
  • partial_payment – частичный расчет и кредит.
  • credit – передача в кредит.
  • credit_payment – оплата кредита.
Наименование
PaymentObject
Обязательный
Нет
Описание
Признак предмета расчёта.Если значение не передано, по умолчанию в онлайн-кассу отправляется признак предмета расчёта "commodity".
Возможные значения:
  • commodity – товар.
  • excise – подакцизный товар.
  • job – работа.
  • service – услуга.
  • gambling_bet – ставка азартной игры.
  • gambling_prize – выигрыш азартной игры.
  • lottery – лотерейный билет.
  • lottery_prize – выигрыш лотереи.
  • intellectual_activity – предоставление результатов интеллектуальной деятельности.
  • payment – платеж.
  • agent_commission – агентское вознаграждение.
  • composite – составной предмет расчета.
  • another – иной предмет расчета.
Наименование
Tax
Обязательный
Да
Описание
Ставка налога.
Перечисление со значениями:
  • «none» – без НДС;
  • «vat0» – НДС по ставке 0%;
  • «vat10» – НДС чека по ставке 10%;
  • «vat20» – НДС чека по ставке 20%;
  • «vat110» – НДС чека по расчетной ставке 10/110;
  • «vat120» – НДС чека по расчетной ставке 20/120
С 1 января 2019 года ставка НДС 18% изменилась на 20%.
— Если из магазина получен параметр «vat18», он будет изменен на «vat20» на стороне Тинькофф. В кассовый сервис будет передано значение НДС = 20%.
— Аналогично, параметр «vat118» будет изменен на «vat120» - в кассовый сервис будет передано значение НДС = 20/120.
В Items значение параметра Amount рекомендуется проверять на соответствие значению Price * Quantity.
Параметр Amount в поле ввода платежного Виджета должен быть равен сумме значений параметра Amount объектов Items:
Показать пример кода
<input class="tinkoffPayRow" type="text" placeholder="Сумма заказа" name="amount">
Остальные возможности
Если вы хотите использовать расширенные возможности и управлять платежом, используйте API

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

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