Створення магазина
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 | 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 - Успішний запит, 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 - Послуга оплати частинами не є доступною для вашого підприємства. Рекомендуємо видалити пов'язаних осіб з керівників та співзасновників.
Last updated