Перейти к основному содержимому

Песочница

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

Адрес и токен​

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

ПараметрЗначение
Базовый адресhttps://enter.tochka.com/sandbox/v2
Токенsandbox.jwt.token

Токен передаётся так же, как в боевой среде — в заголовке:

Authorization: Bearer sandbox.jwt.token
Инфо

Боевой адрес вида https://enter.tochka.com/uapi/open-banking/v1.0/... в песочнице заменяется на https://enter.tochka.com/sandbox/v2/open-banking/v1.0/.... Остальная часть пути и тела запросов совпадает с продуктовой средой.

Тестовые данные (креды)​

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

ИдентификаторЗначениеДля чего
customerCode1234567abкод тестовой компании
accountId12345810901234567890/044525104тестовый счёт
merchantId200000000001097торговая точка для платёжных ссылок

Все данные захардкожены​

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

Что это значит на практике:

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

Особенность платёжных ссылок​

Важно

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

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

Как начать​

  1. В Postman (или своём коде) укажите базовый адрес https://enter.tochka.com/sandbox/v2.
  2. В авторизации выберите Bearer Token и впишите sandbox.jwt.token.
  3. Подставляйте тестовые customerCode, accountId, merchantId из таблицы выше.
  4. Когда структура запросов отлажена — переключитесь на продуктовую среду, сгенерируйте реальный JWT-ключ и используйте свои идентификаторы.
Совет

Пошаговая настройка окружения для песочницы описана в разделе Коллекция запросов.

Реализованные методы​

Сейчас в песочнице можно вызвать все методы из следующих разделов: