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

URL

Тип запроса

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
Счет для возмещения для магазина(в формате 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 - неверные ОКПО или номер счета
installment payment service is not available for your - Услуга оплаты частями не доступна для вашего предприятия. Рекомендуем удалить связанных лиц с руководителей и соучредителей.