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

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 Уникальный номер платежа