Заведение получателя

URL

https://payparts2.privatbank.ua/ipp/recipient/api/create

Тип запроса

POST

Заголовки

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

Тело запроса

{
    "account": 26001052637412,
    "okpo": "2049801152",
    "identifier": "429FC8284CA8F5",
    "signature": "/8IZMl9HHd3YKyIrzsc="
}

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

Поле Описание Обязательное
identifier Идентификатор магазина Да
okpo Окпо юр лица Нет (если IBAN)
account Счет для возмещения(2600* или IBAN) Да
signature Уникальная подпись транзакции Да

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

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

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

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

{
    "state": "SUCCESS"
}

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

{
    "state": "FAIL",
    "message": "bad value: Unknown identifier. Store not found."
}

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

Состояние Описание
state SUCCESS - Получатель успешно добавлен, FAIL - Ошибка при создании получателя
message Сообщение об ошибке