Skip to main content

Платежная форма банка

Платежная форма — это готовый интерфейс со встроенными способами оплаты, который позволяет принимать платежи онлайн. Используется при проведении платежей через:

Протестировать платежную форму можно по ссылке.

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

Включить

Чтобы включить платежную форму:

  1. Настройте терминал — в личном кабинете интернет-эквайринга перейдите в раздел Магазины и на вкладке Терминалы нажмите Настроить. Выберите тип подключения Универсальное.

  2. Включите нужные способы оплаты — на вкладке Прием оплаты в блоке Готовая платежная форма от Т-Банка нажмите Настроить и включите нужные способы.

Использовать

Чтобы платежная форма открылась на вашем сайте, ваш бэкенд-сервис должен:

  1. Вызвать метод Инициировать платеж и передать PaymentURL из ответа метода во фронтенд-приложение.
  2. Произвести редирект на полученный URL. Предпочтительный способ — JS-код. Если вы используете HTML-тег <form> для редиректа, используйте method="GET".
  • Платежная форма поддерживает темную и светлую темы, которые переключаются автоматически в соответствии с настройками ОС покупателя. Чтобы задать тему принудительно, добавьте ?theme=dark или ?theme=light к PaymentURL из ответа метода Инициировать платеж.
  • Также вы можете выбрать язык платежной формы — русский или английский. Чтобы задать его принудительно, добавьте ?language=ru или ?language=en к PaymentURL из ответа метода Инициировать платеж.

Быстрый старт

  • Перед началом приема платежей пройдите все шаги из чек-листа.

  • Ниже представлен стандартный процесс проведения платежа при оплате картой.

Платеж в интернет-эквайринге имеет свой жизненный цикл — от создания платежа до его завершения или возврата/отмены.

Для проведения платежа:

  1. Создайте платеж.
    Для создания платежа вызовите метод Инициировать платеж и передайте обязательные параметры: TerminalKey, Amount, OrderId и Token. В объекте DATA укажите параметр OperationInitiatorType.
    При использовании онлайн-кассы — передайте объект Receipt.
  2. Проведите платеж.
    В ответе метода Инициировать платеж вы получите параметр PaymentURL. Переадресуйте на него покупателя, чтобы он попал на платежную форму Т-Банка и ввел данные своей карты или выбрал другой способ оплаты.
  3. Проверьте статус платежа.
    Чтобы получить информацию о платеже, настройте уведомления.
    Статус платежа возвращается в параметре Status из ответа метода Инициировать платеж. При успешном платеже вернется статус CONFIRMED. Поздравляем, вы приняли первый платеж! Подробнее о статусах в справочнике.
  4. Отмените или проведите возврат платежа.
    Вы можете отменить платеж в любом статусе.

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie» с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.