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

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

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

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

Какие есть методы:

• Бенефициары и реквизиты
• Биллинг
• Депоненты и реципиенты
• Управление сделками
• Управление этапами сделок
• Платежные требования

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

Детали:

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

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

Примерный порядок вызова методов

1. Добавьте бенефициаров — будущих депонентов и реципиентов.

2. Посмотрите результат проверки бенефициара в финмониторинге.

3. Добавьте бенефициарам реквизиты РКЦ или номер карты. Этот шаг может быть позже — депоненту нужно привязывать реквизиты, если ему будет совершаться выплата.

4. Создайте сделку и этап (выплату).

5. Привяжите бенефициара как депонента к этапу сделки.

6. Привяжите бенефициара как реципиента к этапу сделки.

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

7. Подтвердите параметры сделки.

8. Идентифицируйте пополнения. Этот шаг мог быть выше, когда пришло пополнение номинального счета депонентом:

   • Получите список всех неидентифицированных пополнений.
   • Идентифицируйте конкретное пополнение — привяжите средства к бенефициару.

9. Завершите этап. Допускаем, что по сделке только один этап.

10. Убедитесь, что выплаты по этапу прошли успешно. Проверьте:

    • Статусы платежей в рамках сделки. Здесь также можно узнать информацию о платеже через метод Получить платеж по ID платежа по paymentsId.
    • Статус этапа сделки.
    • Статус сделки.

Дополнительная информация:

Интеграция

Чтобы протестировать работу интеграции, используйте песочницу.

Если вы будете управлять счетом своей компании:

1. Выпустите токен.

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

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

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

2. Выпустите mTLS-сертификат. Он действует 1 год.

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

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

Документация T‑IDСценарий подключения

Через сервис T‑ID T‑Банк отправляет данные физических и юридических лиц. Вы сможете забирать данные по бенефициарам без идентификации данных на своей стороне.

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

1. Вы интегрируете кнопку Войти с T‑ID.

   • Рекомендации по размещению кнопок T‑ID

   • Как интегрировать T‑ID на сайт и в приложение

2. Передаете нам данные по вашим бенефициарам через метод Создать бенефициара и проверяете их корректность.

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

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

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

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

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

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

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

Roadmap

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

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

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

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

FAQ