Получение результата сделки

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 Пароль вашего магазина