Добавление описания платежа

URL

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

Тип запроса

POST

Заголовки

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

Тело запроса

{
  "storeId" : "",
  "orderId" : "ORDER-3196fa3007bc4b6dab8",
  "description": "",
  "signature" : ""
}

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

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

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

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

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

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

{
  "state" : "SUCCESS",
  "message":"description successfully updated"
  "signature" : ""
}

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

{
  "state" : "FAIL",
  "message" : "error message",
  "signature" : ""
}

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

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

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