Заглушки для ном. счета v2

Обновлено 20 февраля 2025

Сервис предназначен для тестирования расчетов через номинальный счет с множеством бенефициаров

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

Особенности работы с заглушками

1. Согласно требованиям спецификации во всех POST-запросах необходимо передавать значение signature. В заглушках отключена проверка электронных подписей, поэтому в параметре запроса signature допустимо указывать произвольное значение, удовлетворяющее требованию спецификации. В простейшем случае можно передавать одну латинскую букву, цифру или знак сложения (+).

2. Особенности запроса POST signup.

   a) В заглушках не проверяется статус номера номинального счета. Поэтому в параметре запроса nominalAccountNumber допустимо указывать произвольное значение, удовлетворяющее требованию спецификации. Для одного clientId возможна работа только с одним номинальным счетом.

   b) В заглушке signup реализована возможность очистки всех записей клиента. Для этого необходимо в параметре запроса signup указать магическую фразу "mischief+managed". Заглушка ответит на такой запрос статус-кодом 202 Accepted с сообщением "Now the data store is empty". Эта возможность присутствует только в заглушке signup для создания "чистого" окружения при повторном тестировании.

   c) При отправке повторного запроса signup для уже зарегистрированного clientId заглушка ответит статус-кодом 409 Conflict с сообщением "Application for nominal account already exists".

3. Особенности запроса POST beneficiaries. Во время регистрации каждого нового бенефициара номинального счета баланс бенефициара сразу пополняется фиксированной суммой 100 000 рублей. Этими средствами возможно распоряжаться в сделках или вывести с номинального счета, полностью или частично. Пополнение баланса бенефициара в заглушках не предусмотрено.

4. В запросе вывода средств со счета бенефициара (POST beneficiaries/moneyback) допустимо указывать произвольные значения subject, удовлетворяющие спецификации.

5. В запросах создания и завершения смарт-контракта (POST smart-contracts и POST smart-contracts/completion) допустимо указывать произвольные значения contractors, удовлетворяющие требованию спецификации.

6. В запросе подтверждения шага смарт-контракта (POST smart-contracts/confirmstep) допустимо указывать произвольные значения payee, удовлетворяющие требованию спецификации.

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

Заглушки совместимы со Смарт-контрактами на ном. счете v3

Запрос

• OAuth 2.0: OAuth2

Security Scheme Type:	oauth2
OAuth Flow (clientCredentials):	Token URL: https://mc.api.sberbank.ru/prod/tokens/v3/oauth Scopes: auth://sbersmartcabinet/nominal-account: Общий скоуп для доступа ко всем методам