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

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 - неверные ОКПО или номер счета