Створення магазина

URL

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

Тип запиту

POST

Headers

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

Body запиту

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

Опис полів

Поле	Опис	Обязательное
agentId	Ідентифікатор агента	так
name	Найменування нового магазину	так
webAddress	URL веб-адреси нового магазину	так
okpo	Окпо юр особи для магазину	ні(якщоIBAN)
account	Рахунок для відшкодування для магазину (у форматі IBAN)	так
phone	Мобільний телефон адміністратора для магазину	так
acquiringFee	Ставка комісії для транзакції магазину	так
signature	Унікальний підпис транзакції	так

Розрахунок сигнатури для запиту

SIGNATURE - підпис запиту, обов'язковий параметр вважається за формулою: encodeBase64 ( SHA1 ( password + agentId + name + phone + okpo + account + webAddress + password )), де:

• encodeBase64 () - Функція зашифровує рядок у форматі BASE64;

• SHA1 () - Стандартна хеш-функція SHA-1 повинна повертати бінарні дані;

• "+" - Конкатенація текстового рядка.

Параметр	Значення
password	Пароль вашого магазину
agentId	Ідентифікатор агента
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 - Послуга оплати частинами не є доступною для вашого підприємства. Рекомендуємо видалити пов'язаних осіб з керівників та співзасновників.