Интеграция с эквайрингом Т-Банка: ссылки на оплату, статус и возвраты

Интеграция с интернет-эквайрингом Т-Банка (бывший Тинькофф) в nana800 создаёт ссылку на оплату, проверяет, оплачен ли заказ, списывает замороженные деньги и делает возвраты без кода и своего сервера. Нужны ключ и пароль вашего терминала, а деньги идут на ваш расчётный счёт по договору с Т-Банком, не на счёт nana800. Каждая операция стоит 0,20 ₽, а баланс каждый месяц бесплатно пополняется до 350 ₽.

Собрать в конструкторе
  • Запуск блока: 0,20 ₽
  • Бесплатно каждый месяц: 350 ₽
  • Карта не нужна

Что можно сделать

  • Создавать платёж в рублях и получать ссылку на платёжную форму Т-Банка, чтобы отправить её покупателю
  • Проверять, оплачен ли платёж, и выдавать товар только после подтверждённой оплаты
  • Принимать уведомления Т-Банка о смене статуса платежа через триггер «webhook»
  • Работать с двухстадийной оплатой: деньги сначала замораживаются на карте, потом вы их списываете или отменяете заморозку
  • Возвращать деньги покупателю целиком или частично
  • Передавать данные чека, если к терминалу подключена онлайн-касса
  • Подставлять почту и телефон покупателя в форму оплаты и задавать страницы после успешной и неудачной оплаты

Блоки в конструкторе

  • Эквайринг Т-Банка

    Действие · 0,20 ₽ за запуск

    Работает с вашим терминалом: create_payment создаёт платёж и ссылку на оплату, get_payment_state проверяет статус, confirm_payment списывает замороженные деньги, cancel_payment отменяет платёж или возвращает деньги.

Как настроить

  1. 1

    Скопируйте ключ и пароль терминала

    В личном кабинете интернет-эквайринга Т-Банка откройте раздел «Магазины», выберите магазин и на вкладке «Терминалы» скопируйте ключ терминала и пароль. Пароль секретный: по нему блок подписывает запросы, а в журнале запусков и экспорте схемы он скрыт.

  2. 2

    Создайте платёж

    Создайте схему, поставьте триггер с данными заказа, например «webhook» для заявки с сайта, и добавьте блок «T-Bank Acquiring» с операцией create_payment. Укажите сумму в рублях (блок сам переведёт её в копейки) и описание до 140 символов, по желанию номер заказа, почту и телефон покупателя.

  3. 3

    Отправьте ссылку покупателю

    Добавьте блок «Telegram message send» или письмо и подставьте ссылку из поля payment_url блока Т-Банка. По умолчанию ссылка действует сутки, срок меняется в настройках терминала.

  4. 4

    Примите уведомление об оплате

    Во второй схеме поставьте триггер «webhook» с методом POST и вставьте его адрес в поле «Куда прислать уведомление об оплате» или в настройки терминала. Перед выдачей товара перепроверьте платёж операцией get_payment_state: поле is_paid должно быть true.

  5. 5

    Включите схему и проверьте без денег

    Включите схему, для проверки выберите среду test и платите тестовыми картами из документации Т-Банка. Затем верните среду production и оставьте схему включённой: пока она включена, она стоит 0,42 ₽ в час.

Частые вопросы

Каждая операция блока стоит 0,20 ₽: создать ссылку, проверить статус, списать или вернуть деньги. Включённая схема стоит 0,42 ₽ в час. Баланс каждый месяц бесплатно пополняется до 350 ₽, карта не нужна, а у схемы, включённой круглосуточно, большая часть этой суммы уходит на часы работы. Комиссию за эквайринг берёт Т-Банк по вашему договору, nana800 процент с платежей не берёт.

На ваш расчётный счёт по договору эквайринга с Т-Банком. Блок работает с вашим собственным терминалом, nana800 деньги покупателей не получает и не хранит.

Выберите в блоке среду test. Т-Банк принимает тестовые платежи только на боевом терминале (ключ без слова DEMO) и только с разрешённых адресов: напишите в чат личного кабинета Т-Банка ИНН, название организации и адрес сервера, который подскажет поддержка nana800.

Тогда Т-Банк требует данные чека. Передайте их в поле «Данные чека (JSON)»: систему налогообложения и позиции, цены и суммы в копейках, причём сумма позиций должна совпасть с суммой платежа. Почта и телефон покупателя подставятся в чек сами.

При схеме оплаты two_stage деньги сначала замораживаются на карте покупателя. Вы подтверждаете заказ и списываете их операцией confirm_payment, можно и меньшую сумму, или снимаете заморозку операцией cancel_payment.

Блок вернёт success равный false и ответ Т-Банка в error_message. Создание платежа, списание и отмена после обрыва связи сами не повторяются, чтобы не сделать одно действие дважды: узнайте, прошёл ли запрос, операцией get_payment_state.

Соберите первую схему бесплатно

Регистрация бесплатная, карта не нужна. Каждый месяц баланс бесплатно пополняется до 350 ₽, этого хватает примерно на 3 500 запусков простых блоков.

Собрать в конструкторе