Привет! Сегодня рассказываем, как немного упростить себе жизнь

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

В разделе:

— Финансовый учёт и бухгалтерия. Например, Финтабло, Контур Эльба, Моё дело. Можно автоматизировать учёт денег, ведение бухгалтерии, отчётность и обмен документами с банком.

— Бизнес и управленческий учёт. Planior, Сметтер, Мой склад, Финолог и другие. Можно настроить финансовый и управленческий учёт, бюджетирование, автоматизацию строительного бизнеса.

— CRM-системы. Аспро.Cloud, виджет Тинькофф B2B в amoCRM, OkoCRM и другие. Автоматизация бизнес-процессов, формирования счетов, обмен платёжными поручениями и управление компанией.

Раздел пополняется. Пользуйтесь ✅

Привет!

Сегодня рассказываем про наш портал разработчика и его текущий функционал. Сейчас в нём есть 6 разделов:

✨Подключение

Инструкции, с помощью которых можно:

— разобраться в выпуске токена и сертификата;
— прочитать про различия прямой (H2H) и партнёрской интеграции и посмотреть, как их подключить;
— изучить наши вебхуки;
— прочитать про песочницу, Postman, запросы 1С и работу с ними;
— посмотреть другие API банка, к которым тоже можно подключаться.

✨API

Раздел преимущественно для разработчиков.

Здесь собраны все методы Tinkoff API по нашим продуктам. В каждом методе прописываем описания полей и даём примеры запросов и ответов, чтобы вам было проще интегрироваться.

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

✨Сценарии

Варианты подключения интеграций по продуктам — Tinkoff ID, платежи, безакцепты, номинальные счета и другие.

На странице каждого продукта рассказываем:

— о самом продукте и подключении к нему,
— какие есть методы и вебхуки,
— про возможные ошибки.

✨SDK

В разделе собрали все SDK Тинькофф.
Сейчас разрабатываем SDK для бизнеса — пожелания можно оставить в опросе.

✨Поддержка

В разделе собрали ответы на самые часто задаваемые вопросы по работе с API — про интеграцию, сертификаты, токены и другие.

Также здесь можно связаться с нашими техническими специалистами через заявку — интегратором и технической поддержкой, если что-то не получается или непонятно.

✨Готовые интеграции

Страница с нашими партнёрами для интеграции без написания кода — финансы, бизнес, CRM. В среднем эти интеграции занимают не больше 5 минут.

В комментариях можете оставить пожелания к функционалу нашего портала — рассмотрим и учтём. ⚡️

Привет! Сегодня рассказываем про выпуск сертификата

Напоминаем, что выпуск происходит через личный кабинет — вручную ничего создавать не нужно.

Раньше для выпуска сертификата ваш разработчик формировал CSR-запрос, вы заполняли анкету в doc, подписывали заявление и отправляли нам. После этого наша поддержка выпускала сертификат — это занимало до двух дней, в выходные дни выпусков не было.

Сейчас это делается через личный кабинет: выпуск автоматизирован и занимает от 5 до 15 минут, а от вас нужна только КЭП.

Короткий чек-лист для успешного выпуска сертификата:

✅ Убедитесь, что скачанная заявка, которую вы подписываете, и заявка, к которой вы прикладываете подпись — это одна и та же попытка. Если вы подписали заявку из 2 попытки и пытаетесь загрузить её в 3 попытку — выпустить сертификат не получится.

✅ Ваша КЭП должна быть выдана аккредитованным удостоверяющим центром. Проверить УЦ можно на сайте Министерства цифрового развития, связи и массовых коммуникаций РФ.

✅ Убедитесь, что подпись содержит информацию об ИНН компании, а ИНН подписи и ИНН компании, для которой выпускается сертификат, совпадают.

И напоследок, делимся обновлением: теперь на 3 шаге выпуска через ЭДО или Инструменты КриптоПро нужно загружать только подпись. Раньше нужно было загружать заявку и подпись.

Спасибо!

⚡️ Небольшое уведомление в связи с ренеймингом Т-Банка — для всех, кто уже подключился к интеграции по API или только собирается это сделать

Если в коде вашей бизнес-логики вы использовали сравнение по текстовому названию банка, уже официально можно его изменить — «Тинькофф» ➡️ «Т-Банк». В субботу, 27 июля, в справочниках Центрального Банка название было обновлено.

Это значит, что изменились названия банка в выписках и платежах — вам нужно заменить их в коде.

Если в коде вы использовали сравнение по БИК, ничего делать не нужно — БИК банка не менялся.

ИТ-Пикник в Москве — заглядывайте ⚡️

17 августа в Музее-заповеднике Коломенское пройдёт ежегодный фестиваль для ИТ-специалистов.

На Пикнике будет стенд T-API — приходите пообщаться с нашими продактом и тимлидом!)

Что ещё интересного в программе:

👑 творческие воркшопы для всей семьи;

👑 зоны для нетворкинга;

👑 научпоп и ИТ-лектории на темы бизнеса и технологий с экспертами из ведущих ИТ-компаний;

👑 музпрограмма с секретным хедлайнером.

Зарегистрироваться

Всех ждём, будет круто 💛

⚡️А мы к вам с обновлением!

С 20 сентября в личном кабинете Т-Бизнеса появился новый функционал — ограничение счетов при выпуске токена для доступов к следующим продуктам:

— Зарплатный проект,
— Счета и выписки.

Зачем это нужно?

Например, у вашей компании есть несколько счетов для ведения бизнеса: отдельный счет для выплат контрагентам, отдельный — для выплаты заработной платы сотрудников, и так далее.

Вы хотите, чтобы ваши сотрудники, которые будут использовать токен для работы с методами T-API, имели доступ только к определенным счетам компании, с которыми связана их работа.

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

Как это использовать?

Если вы пользователь с ролью «Директор компании»:

✨ В личном кабинете Т-Бизнеса в разделе «Управление пользователями» вы можете настроить доступы к счетам компании для каждого из сотрудников — после этого сотрудники не смогут выпустить токен с доступом к счетам, к которым вы не выдали доступ.

✨ Вы можете выпустить токен для себя или для передачи его своему сотруднику с ограничением доступа только к тем счетам, с которыми будете работать — это поможет предотвратить несанкционированный доступ ваших сотрудников к счетам, к которым у них не должно быть доступа.

Привет! У нас есть две новости. И обе хорошие!)

1️⃣ Пополнение на платформе. Теперь у нас есть:

— Новый продукт Овернайты.

— Новый метод продукта Зарплатный проект — Отменить отправку платежного реестра. Теперь вы сможете отменить ошибочную отправку платежного реестра, даже если он уже находится в статусе ACCEPTED.

2️⃣ Наш портал разработчика становится общебанковским — и будет объединять все API Т-Банка. На разводящей странице уже можно увидеть документацию T-Invest API.

Всем спасибо, оставайтесь с нами 📈

Новости для пользователей метода Выставить счет ❤️

Теперь можно добавить логотип, подписантов и факсимиле в PDF счёта на оплату.

Обратите внимание: если вы уже создавали счета с логотипом и подписантами через личный кабинет, они автоматически проставятся в счета, выставленные через API. Если вам больше не нужны логотип и подпись, их также можно убрать через личный кабинет.

⚡️Инструкция

И еще новости для пользователей метода Выставить счет ⚡

Теперь в ответе вы получаете не только ссылку на PDF-документ, но и ссылку на оплату через личный кабинет Т-Бизнеса — параметр incomingInvoiceUrl. Он возвращается, если в запросе передан ИНН контрагента.

Как это работает

При переходе по ссылке ваш контрагент должен авторизоваться в личном кабинете Т-Бизнеса, проверить данные счета и нажать «Оплатить» или «Отклонить».

При выборе «Оплатить» автоматически создается заполненный черновик платежного поручения с нужными реквизитами.

Привет!

Мы болеем за нашу документацию всей душой и сердцем и хотим, чтобы пользователям (то есть вам) было максимально удобно и просто с ней работать.

Мы постоянно изучаем рынок и анализируем, что можно улучшить. Но самый ценный фидбэк — от вас.

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

Также будем благодарны любой обратной связи: если вам что-то не нравится, чего-то не хватает или просто есть, что сказать — ждем ваше мнение. Унесем на проработку и постараемся всё сделать по красоте.

Чтобы поучаствовать, пройдите опрос

💛

Привет!

Новости для пользователей метода Выставить счет ⭐️

Теперь при создании счета на оплату вы можете передать поле customPaymentPurpose, которое попадет в назначение платежа при сканировании QR-кода или оплате через личный кабинет Т-Бизнеса.

Назначение будет выглядеть так:

{customPaymentPurpose}. Платеж по счету №{invoiceNumber} от {invoiceDate}. {НДС}

Если поля не будет, назначение останется стандартным:

Платеж по счету №{invoiceNumber} от {invoiceDate}. {НДС}

Привет!
Сразу к новостям: в 1С:ДиректБанк появился функционал автовыписок для Т-Бизнеса 🏦

Теперь автовыписки в 1С можно получать по расписанию — для этого нужно настроить интеграцию 1С:ДиректБанка и Т‑Бизнеса и подключить их.

С настройкой «Автоматическое получение выписок по расписанию» в 1С выписки будут приходить раз в час или по индивидуальному расписанию, которое вы установите в 1С.

Подробнее о подключении

Привет! Новости для пользователей метода Выставить счет 💎

1️⃣ Добавили вебхук для получения статуса оплаты по счету — Обновление статуса счета на оплату. Теперь не нужно каждый раз вызывать метод получения информации по счету или придумывать, как распознавать платежи по счету. Мы сами уведомим вас об оплате.

2️⃣ Обновили правила матчинга — блок Принцип работы. Изменения:

🟡 Определим платеж по счету, если сумма платежа равна или больше суммы в счете. Если пришел платеж меньше — например, аванс по счету, мы запомним платеж и отметим счет как оплаченный, только когда придет остальная часть по счету.

🟡 Распознаем платеж по счету, если не был указан ИНН контрагента или контрагент — физлицо.

Такие дела. Спасибо!

🪙🚀 Принимайте оплату от ИП и юрлиц мгновенно — через СБП

Напоминаем, что ваш бизнес может получать деньги 24/7 без задержек — для этого у нас реализованы API-методы Выставление ссылок через СБП.

👑 Выставляйте одноразовые и многоразовые ссылки и QR-коды через СБП
👑 Получайте информацию о выставленных ссылках — сумма, назначение платежа, срок оплаты и другое
👑 Отслеживайте статус оплаты одноразовых ссылок и QR-кодов с помощью вебхуков
💯 Комиссия за прием платежей по СБП B2B — 0,7% от входящего платежа и минимум 29₽ за операцию оплаты

Как это работает

1. Контрагент хочет оплатить услугу
2. Вы генерируете ссылку или QR через T-API
3. Контрагент переходит по ссылке или QR и платит через свой банк (список поддерживаемых — в документации)
4. Вы получаете уведомление об оплате через вебхук или API
5. Заказ закрыт — бизнес-процесс идёт дальше

Подходит для компаний, которым важно:

— Быстро выставлять счета
— Ускорить оборачиваемость
— Убрать задержки из-за банковских реквизитов и платежек

⚡️Методы в документации
💫Подробное описание сценария

⚡️Новости из мира безопасности: теперь в личном кабинете Т-Бизнеса можно выпускать разные типы сертификатов

1️⃣ Раньше вы могли выпускать только mTLS-сертификат типа шифрования RSA. Теперь доступен новый тип шифрования — ГОСТ.

⚠️ Для некоторых сервисов выбор типа шифрования недоступен — в этих случаях по умолчанию выпускается тот тип, который требует законодательство.

2️⃣ Также у нас появился сертификат криптографической подписи.

Для чего он нужен:

🟡✍️ Подписать электронный документ — кроме тех типов документов, где закон требует бумажный носитель подписи.
🟡🔐 Пройти аутентификацию в различных сервисах — например, 1С: Директбанк.

Что важно знать:

➡️ Сертификат выпускается на конкретного сотрудника компании (физическое лицо) — в отличие от сертификата mTLS, который выпускается на компанию (юридическое лицо).

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

➡️ Тип шифрования сертификата — ГОСТ.

➡️ Если вы используете метод, где нужно и защитить канал, и подписать запрос — например, Отправить набор платежных поручений, вам нужно выпустить два сертификата: mTLS и криптографической подписи.

Встречаем новый метод: теперь юрлица могут получать подтверждающие документы по операциям в PDF 🪙

Что можно получать:

✔️ Платежные поручения
✔️ Платежные требования
✔️ Банковские, мемориальные и платежные ордеры
✔️ Инкассовые поручения

Метод в документации

В запросе метода передается уникальный ID операции. Документ возвращается в виде строки в формате Base64, которую можно декодировать и сохранить как PDF-файл.

Возвращаются только исполненные документы — статус «Исполнено» в личном кабинете Т-Бизнес или Transaction (поле operationStatus) в ответе метода Получить выписку по счету

Пример работы на выписках:

1. Вы получили выписку по счету через T-API.
2. Захотели получить платежный документ в формате PDF по определенной операции.
3. Через новый метод получили PDF по ID из выписки.

Получаем подтверждающий документ по операции 📁

Привет! Сегодня рассказываем про метод, который помогает автоматически забирать подтверждающие документы по операциям — GET /api/v1/payment-document

Что умеет метод

Возвращает PDF-документ по конкретной операции, закодированный в Base64. Декодируете строку — получаете готовый файл. RPS — 1 запрос в секунду.

Какие документы доступны:

— Платежное поручение
— Банковский ордер
— Платежное требование
— Инкассовое поручение
— Платежный ордер
— Мемориальный ордер

⚡️Важно: метод возвращает только исполненные документы. Операция должна иметь статус Transaction в методе Получить выписку по счету.

Параметры запроса

Их три, все обязательны:

🟡accountNumber — номер счета (20 цифр)
🟡operationDate — дата операции (ISO 8601, UTC)
🟡operationId — уникальный ID операции из метода /api/v1/statement

Примеры сценариев использования

1. Архив документов по выпискам: бухгалтерская система каждую ночь скачивает выписку → по каждой транзакции запрашивает PDF → складывает документы в архив. Profit — экономим время на ручной работе в личном кабинете.

2. Платежки контрагенту: после проведения платежа система находит операцию в /api/v1/statement → запрашивает подтверждающий документ → отправляет его контрагенту. Исключаем ручные действия и ускоряем коммуникацию с партнерами.

➡️ Документация

⚠️ Отзыв TLS-сертификатов Harica

В публичном поле появилась информация о том, что УЦ Harica также отзывает доверие у российских доменов — видим риск отзыва последнего сертификата для T-API до конца этой недели.

Что нужно сделать сейчас

Оперативно проверить, что у вас настроено доверие к корневым сертификатам Минцифры. В ином случае запросы к T-API и сервису 1С:ДиректБанк перестанут выполняться с ошибкой недоверенного сертификата. 

Если доверие не настроено — по инструкции ниже добавить корневые сертификаты (СА) УЦ Минцифры в список доверенных сертификатов на стороне вашего сервера или инфраструктуры, из которой выполняются запросы к T-API.

➡️ Инструкция для T-API

➡️ Инструкция для 1С:ДиректБанк