Postman-коллекция Webkassa API для интеграторов

1. Важно знать:

Интегратор должен иметь:

  • доступ к тестовой среде Webkassa API (выдаётся в рамках тестирования);

  • Среда: запросы должны выполняться только на test/stage, не на production.

  • тестовую кассу (если требуется по сценарию);

  • логин/токен/ключ доступа (в зависимости от схемы авторизации);

  • понимание базовой логики API Webkassa;

  • Коллекция предназначена только для тестовой среды.

  • Коллекция не заменяет описание API — она дополняет его примерами запросов/ответов.

  • Значения параметров: конкретные base_url, токены и идентификаторы выдаются в рамках тестирования и могут быть ограничены по времени.


2. Инструкция:

2.1 Открыть официальную коллекцию

  1. Откройте ссылку на коллекцию Postman:

    https://documenter.getpostman.com/view/48749526/2sBXc8o3JF

2.2 Импортировать в Postman

  1. Нажмите Run in Postman.

  2. Импортируйте коллекцию в свой Workspace.

2.3 Настроить окружение (Environment)

  1. В Postman задайте переменные окружения (названия могут отличаться — ориентируйтесь на переменные в коллекции):

  • base_url — адрес тестовой среды

  • token / api_key — данные авторизации

  • идентификаторы кассы/организации/точки (если требуются в запросах)

  1. Сохраните Environment и выберите его активным (в правом верхнем углу Postman).

2.4 Проверить авторизацию и базовый запрос

  1. Запустите запрос авторизации из коллекции.

  2. Убедитесь, что токен/ключ сохранился в переменные окружения (если коллекция это делает автоматически).

  3. Запустите любой базовый метод (например, получение данных/проверочный запрос) и проверьте ответ 200 OK (или ожидаемый код).

2.5 Использовать коллекцию для тестирования сценариев

  1. Выполняйте запросы по сценарию тестирования (авторизация → операции → проверка результата).

  2. Для end-to-end используйте чек-лист/сценарии из связанной статьи (если применимо).

Теги