Skip to main content

Номинальные счета Тинькофф

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

Презентация. Номинальный счёт — самозанятые

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

Если перевод с номинального счёта совершается в личном кабинете, это списание не будет отображаться в нашем биллинге.

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

Если логика сломалась:

Общее описание

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

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

Что мы выделяем:


Сразу обязательно интегрироваться с методами Бенефициары и реквизиты — методы Создать бенефициара и Проверить результат скоринга.

Интеграция с остальным биллингом также обязательна, но мы можем дать срок на переход.

Подробнее про каждый блок

Работа с API

Тестирование

Для подключения к песочнице оформлять доступы не нужно. Авторизация происходит через Access Token.

Чтобы использовать Access Token, добавьте заголовок Authorization со значением Bearer TinkoffOpenApiSandboxSecretToken.

Прод

Если будете управлять счётом своей компании, смотрите инструкцию по подключению.

Токен выпускается через Self-сценарий. На 4 шаге в блоке «Выберите, к чему будет доступ через API» выберите Управление номинальными счетами. Остальные галочки можно проставить по необходимости.

  1. Если у вас не статичный API, обратитесь к нам, чтобы мы отключили проверку.
  2. Редактировать токен нельзя.
  3. Обязательно сохраняйте request-Id/error-Id, чтобы потом найти причину ошибки в логах у нас.
  4. Для работы с методами номинального счёта нужна роль sme.signer/sme.director.

Если нужно, при выпуске токена можно указывать несколько API-адресов.

Для работы с нашими методами нужен mTLS-сертификат. Он действует год. Подробнее в инструкции.

1 сертификат = 1 токен. Сертификат нельзя выпускать на несколько токенов. Если меняется токен, нужно менять сертификат.

Наш Roadmap

Сейчас в рамках наших методов полноценно работают решение с выплатами по РКЦ, выплаты в налоговую, налоговые копилки, мгновенные выплаты (A2C) с заполнением формы банка на проде.

Для партнёров с PCI DSS готовы предложить интеграцию с передачей зашифрованных карточных данных.

СБП пока можно подключить только через сторонние методы. Но биллинг через сторонние методы работать не будет — идентификация пополнений, сделки и так далее.

Tinkoff ID для идентификации бенефициаров

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

Tinkoff ID для физических лиц

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

Как работает процесс:

  1. Вы интегрируете кнопку Войти с Тинькофф. Версии для вёрстки.
  2. Дальнейшие технические шаги описаны в документации.
  3. Передаёте нам данные по вашим бенефициарам через метод Создать бенефициара.
  4. Проверяете через метод, что с данными всё хорошо.

Tinkoff ID для юридических лиц

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

Как работает процесс:

  1. Вы интегрируете кнопку Войти с Тинькофф. Версии для вёрстки.
  2. Дальнейшие технические шаги описаны в документации.
  3. Передаёте нам данные по вашим бенефициарам через метод Создать бенефициара.

Регистрация чеков/интеграция с ФНС

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

Чеки можно будет формировать во время проведения выплаты с номинального счёта.

Если у вас есть пожелания к разработке, пишите нам.

У нас уже есть доступный сервис для проведения выплат через расчётные счета — «Выплаты самозанятым». В его рамках реализованы:

  • установка исполнителя на учёт в налоговой с его согласия;
  • проверка статусов исполнителей в налоговой;
  • проведение оплат;
  • формирование чеков;
  • удержание налога за самозанятого с его согласия.

Подробнее о сервисе

F. A. Q.

openapi@tinkoff.ru

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

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