Добавление получателя

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	Сообщение об ошибке