ym88659208ym87991671
Коллекция Pоstman | Документация для разработчиков

Коллекция Pоstman

Обновлено 26 декабря 2023

Для проверки работы сервисов в ручном режиме можно использовать подготовленную коллекцию:

SandBox SberPay.QR.postman_collection.json

Краткая инструкция по использованию коллекции сервисов SandBox SberPay QR в Postman

Обновлено 26 декабря 2023
  1. Загрузка коллекции - импорт коллекции в Postman:

    1. Перейти в настройки Postman (File --> Import);

    2. В открывшемся окне "Import" нужно нажать на кнопку "Upload Files" и выбрать сохраненный файл коллекции "Mock коллекция SberAPI сертификат Минцифра.postman_collection.json" из директории и нажать на кнопку "Открыть";

    3. Для загрузки коллекции нужно нажать на кнопку "Import", для выхода нажать на кнопку "Cancel";

  2. Добавление сертификата - для использования коллекции нужно применить сертификат, полученный на портале для SandBox:

    1. Перейти в настройки Postman (File Settings);

    2. В окне «Settings» перейти на вкладку «Certificates»;

    3. Нажать на кнопку «Add Certificate»;

    4. В открывшемся окне нужно заполнить следующие поля:

      1. Host – mc.api.sberbank.ru:443;

      2. PFX file – добавить сертификат, выпущенный на портале;

      3. Passphrase – ввести пароль от сертификата;

    5. После заполнения полей нужно нажать на кнопку «Add»;

  3. Авторизационные данные - для авторизации запросов используется тип "Basic Auth":

    1. Во вкладке Authorization следует выбрать тип: Type = «Basic Auth»;

    2. В поле «Username» вводится client_id;

    3. В поле «Password» - client_secret.

  4. Переменные коллекции - используются в базовых сценариях для выполнения запросов без дополнительных манипуляций. При желании переменные можно изменить на валидные значения полей (валидность можно проверить в таблицах параметров запросов и ответов)

    VARIABLE / ПеременнаяКраткое пояснениеГде применяется
    creation_tokenТокен создается в сервисе Access Token Creation, необходим для доступа к сервису Create. Срок жизни токена 60с.Create - Authorization
    status_tokenТокен создается в сервисе Access Token Status, необходим для доступа к сервису Status. Срок жизни токена 60с.Status - Authorization
    order_idИдентификатор заказаCreate - тело ответа (сохраняется в память); Status, Revocation, Cancel – тело запроса (подставляется из памяти)
    order_numberНомер заказа в CRM КлиентаCreate, Status
    revocation_tokenТокен создается в сервисе Access Token Revocation, необходим для доступа Create. Срок жизни токена 60с.Revocation - Authorization
    cancel_tokenТокен создается в сервисе Access Token Cancel, необходим для доступа к сервису Cancel. Срок жизни токена 60с.Cancel - Authorization
    registry_tokenТокен создается в сервисе Access Token RegistryQR, необходим для доступа к сервису RegisrtyQr. Срок жизни токена 60с.Registry - Authorization
    auth_codeКод авторизации – любое валидное значение; в коллекции по умолчанию “12345”Cancel
    rquidУникальный идентификатор запросаВо всех сервисах
    member_idИдентификатор клиентаCreate
    sbp_member_idИдентификатор клиента в СБП. Для Сбербанка: константа: 100000000111Create СБП QR
    id_qrИдентификатор устройства, на котором сформирован заказCreate QR, Cancel
    tidУникальный идентификатор терминалаCreate СБП, Status, Cancel
    order_sumСумма заказа в копейках; в коллекции настроена как рандомное число от 0 до 1000.Сreate
    todayПеременная для генерации текущей даты; в registry применяется для предоставления реестра операций за день. При желании можно изменить на любое валидное значение даты и времени.REGISTRY
    tmПеременная для генерации текущей даты и времениВо всех сервисах
    position_sumСумма конкретной позиции заказа в копейках; в коллекции настроена как рандомное число от 0 до 1000.Сreate
    operation_idИдентификатор операции (оплаты/возврата)Status – тело ответа (отдельно по каждой операции); подставляется в тело запроса Cancel – например, для возврата или отмены оплаченного заказа.
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.