Подтверждение платежа

URL

https://payparts2.privatbank.ua/ipp/v2/payment/confirm

Тип запроса

POST

Заголовки:

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

Тело запроса

{
    "storeId": "",
    "orderId": "9DA37124F46test8",
    "signature": "Gnk2CncQ62I5eVOb0/bRM="
}

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

Поле	Формат	Описание	Обязательное
storeId		Идентификатор магазина	Да
orderId	64 символа	Уникальный номер платежа	Да
signature	Результат функции SHA1(описание ниже).	Уникальная подпись транзакции	Да

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

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

• encodeBase64 () - Функция зашифровывает строку в формате BASE64;

• SHA1 () - Стандартная хеш-функция SHA-1, должна возвращать бинарные данные;

• "+" - Конкатенация текстовой строки.

Параметр	Значение
password	Пароль вашего магазина
storeId	Идентификатор магазина
orderId	Уникальный номер платежа

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

{
    "state": "SUCCESS",
    "storeId": "",
    "orderId": "9DA37124Fest8",
    "signature": "Gnk2CncQ62I5RM"
}

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

{
    "state": "FAIL",
    "storeId": "",
    "orderId": "order_id",
    "message": "error message",
    "signature": "37d9c97324fb4b0fa"
}

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

Состояние	Описание
state	SUCCESS - Платеж успешно подтвержден, FAIL - Ошибка при подтверждении платежа
storeId	Идентификатор магазина
orderId	Уникальный номер платежа
message	Сообщение об ошибке
signature	Подпись запроса

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

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

• encodeBase64 () - Функция зашифровывает строку в формате BASE64;

• SHA1 () - Стандартная хеш-функция SHA-1, должна возвращать бинарные данные;

• "+" - Конкатенация текстовой строки.

Параметр	Значение
password	Пароль вашего магазина
storeId	Идентификатор магазина
orderId	Уникальный номер платежа