Получение статуса платежа

URL

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

Тип запроса

POST

Заголовки

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

Тело запроса

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

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

Поле	Формат	Описание	Обязательное
storeId		Идентификатор магазина	Да
orderId	64 символа	Уникальный номер платежа	Да
showRefund		true - получить детали возвратов по платежу, false - получить статус платежа без дополнительных деталей о возвратах	Нет
showAmount		true - получить сумму сделки, false - не получать.	Нет
signature		Уникальная подпись транзакции	Да

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

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

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

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

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

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

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

{
  "state" : "",
  "paymentState" : "",
  "storeId" : "merchant",
  "orderId" : "order_id",
  "signature" : ""
}

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

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

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

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

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

SIGNATURE = encodeBase64 ( SHA1 ( password + state + storeId + orderId + paymentState + message + password ))

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

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

• withoutFloatingPoint () - Функция возвращает число без плавающей точки ;

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

Параметр	Значение
password	Пароль вашего магазина
state	Результат отработки запроса
storeId	Идентификатор магазина
orderId	Уникальный номер платежа
message	В случае ошибки, содержит сообщение ошибки
paymentState	Статус обработки заявки на кредит
password	Пароль вашего магазина