Создание магазина

URL

https://payparts2.privatbank.ua/ipp/agent/add/store

Тип запроса

POST

Заголовки

Название Значение
Accept: application/json;
Accept-Encoding: UTF-8;
Content-Type: application/json; charset=UTF-8;

Тело запроса

{
    "agentIdentifier": ,
    "name": "",
    "webAddress": "",
    "account":"",
    "okpo":"",
    "phone":"",
    "acquiringFee":"",
    "signature": "/8IZMl9RqUVJEBmHHd3YKyIrzsc="
}

Описание полей

Поле Описание Обязательное
agentIdentifier Идентификатор агента Да
name Наименование нового магазина Да
webAddress URL вебадреса нового магазина Да
okpo Окпо юр лица для магазина Нет (если IBAN)
account Счет для возмещения для магазина(2600* или IBAN) Да
phone Мобильный телефон администратора для магазина Да
acquiringFee Ставка комиссии для транзакции магазина Да
signature Уникальная подпись транзакции Да

Расчет сигнатуры для запроса

SIGNATURE - подпись запроса, обязательный параметр считается по формуле :
encodeBase64 ( SHA1 ( password + agentIdentifier + name + phone + okpo + account + webAddress + password )), где:

  • encodeBase64 () - Функция зашифровывает строку в формате BASE64;
  • SHA1 () - Стандартная хеш-функция SHA-1, должна возвращать бинарные данные;
  • "+" - Конкатенация текстовой строки.
Параметр Значение
password Пароль вашего магазина
agentIdentifier Идентификатор агента
name Наименование нового магазина
webAddress URL вебадреса нового магазина
okpo Окпо юр лица для магазина
account Счет для возмещения для магазина
phone мобильный телефон администратора для магазина

Успешный ответ

{
    "state": "SUCCESS",
    "storeId": "asdhfalsdgf",
    "storePassword": "asdfasdfasdf"
}

Ответ с ошибкой

{
    "state": "FAIL",
    "message": "bad value: Unknown agentId. Send Your agent identifier."
}

Описание полей

Состояние Описание
state SUCCESS - Успешный запрос, FAIL - Ошибка при обработке запроса
storeId Идентификатор магазина
storePassword пароль магазина
message Сообщение об ошибке

Возможные сообщения об ошибке:

bad value: web address is not valid - невалидный веб адрес магазина. Паттерн для веб адреса: regexp = "^(https?|ftp|file)://[-\p{L}0-9+&@#/%?=~_|!:,.;]*[-\p{L}0-9+&@#/%=~_|]"

bad value: Unknown agentId. Send Your agent identifier. - не верный идентификатор агента.

bad value: Wrong signature. Read the FAQ on the generation of signatures. - Неверно рассчитана сигнатура для запроса.

bad value: agentId length should be no more than 20 - параметр identifier должен быть не более 20 символов.

phone must begin with +380 and contains 13 digits(with +380) -не верный формат телефона.

wrong details - неверные ОКПО или номер счета