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

Порядок тестирования методов

инфо

Чтобы проверить работу методов, вы можете использовать готовую коллекцию запросов для Postman. Если вы будете проверять запросы прямо из кода или автоматизировать тестирование, вот URL тестового слоя: https://pre.tochka.com/api/v1/cyclops.

Как получить доступ к тестовому слою

Коротко о бизнес-процессе сервиса​

С помощью Расчётов по номинальному счёту пользователи вашего сервиса могут заключать друг с другом сделки.

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

В одной сделке может участвовать несколько бенефициаров.

Доступность сервиса и подписание запросов​

В первую очередь выполните запрос Проверить доступность сервиса, чтобы убедиться, что сервис доступен, запросы успешно отправляются и авторизация (подписание запросов) работает.

Если вернётся ошибка авторизации, проверьте, верно ли подписан запрос.

Если метод выполнился успешно, переходите к следующим шагам тестирования.

Проверка бенефициара​

  1. Создайте бенефициара. Для этого используйте соответствующий метод:

  1. Если бенефициар ИП или физлицо, добавьте его документы — они нужны для подтверждения личности бенефициара. Это можно сделать методом Добавить документы бенефициара — ИП или физлица.

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

  3. Проверьте, что договор загрузился — выполните запрос Получить данные загруженного документа.

  4. После этого создайте виртуальный счёт.

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

Чтобы создать такой счёт, используйте метод Создать виртуальный счёт.

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

  2. Активируйте бенефициара методом Активировать бенефициара.

  3. Проверьте обновление данных бенефициара. Например, изменение его фамилии для ИП и физлиц или изменение КПП для юрлица.

  1. Убедитесь, что данные бенефициара обновились — с помощью метода Получить данные бенефициара.

Проверка платежей​

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

Если этого не сделать, деньги вернутся отправителю через 96 часов после поступления (на тестовом слое это время сокращено до 30 минут).

Неидентифицированный платёж​

Сначала проверьте неидентифицированный платёж:

  1. Пополните номинальный счёт через сервис Tender-Helpers с помощью метода Перевод денег.

  2. Получите список неидентифицированных платежей. Для этого вызовите метод Получить список платежей, указав "identify": false.

  3. Получите информацию о платеже, которым вы пополнили счёт — с помощью метода Получить данные платежа.

  4. Через 30 минут получите информацию о платеже ещё раз. Статус платежа должен измениться на CANCELED — это значит, что платёж отменён и деньги вернулись отправителю.

Идентифицированный платёж​

Чтобы проверить идентифицированный платёж:

  1. Пополните номинальный счёт ещё раз.

  2. Получите список платежей методом Получить список платежей, указав "identify": true.

  3. Сохраните идентификатор платежа из ответа.

  4. Получите информацию о платеже методом Получить данные платежа, чтобы убедиться, что теперь бенефициар указан в платеже. Данные бенефициара находятся в объекте payer.

  5. Идентифицируйте платёж с помощью метода Идентифицировать платёж.

Возврат платежа с виртуального счёта​

С помощью метода Вывести деньги с виртуального счёта можно вернуть отправителю идентифицированный платёж. Проверьте работу этого метода, а затем получите детали платежа методом Получить данные платежа.

Тестирование сделки​

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

  1. Создайте сделку методом Создать сделку.

  2. Обычно сделка подтверждается документом, который заключают заказчик с исполнителем. Это может быть акт, договор оказания услуг или другой документ, отражающий данные сторон сделки, сумму к оплате и прочие детали. Загрузите этот документ с помощью метода Загрузить документ по сделке.

  3. Проверьте наличие загруженного договора — Получить данные загруженного документа.

  4. Обновите сделку. Обратите внимание, этот метод работает как PUT-запрос и перезаписывает данные сделки. Обновить можно сделки во всех статусах, кроме closed и in_process, и нельзя изменить сумму сделки и получателей, по которым уже прошли выплаты.

  5. Исполните сделку методом Исполнить сделку. После этого исполнитель должен получить деньги на счёт, который вы указали при создании сделки.

  6. Проверьте статус сделки — Получить данные сделки. После исполнения сделки он должен быть в значении closed. Также проверьте данные в объектах payers и recipients — что выплаты заказчикам и исполнителю отображены корректно.

  7. Создайте новую сделку, а затем отмените её — методом Отменить сделку. Отменить можно только сделки в статусе new, в остальных случаях вернётся ошибка.