Возврат

URL

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

Тип запроса

POST

Заголовки

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

Тело запроса

{
  "storeId" : “asfdasdfasdf",
  "orderId" : "ORDER-3196fa3007bc4b6dab8",
  "amount": 300.00,
  "recipientId":"qwerty1234",
  "signature" : "vBh0dOhvJuUz1tKOrNVZy/Q34zo="
}

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

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

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

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

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

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

{
  state: "SUCCESS",
  storeId: "X1114B6L",
  orderId: "ORDER-3196fa3007bc4b6dab8",
  signature: "2CnBRCAqV/BfNghrHUvHjEcGJZk="
}

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

{
  state: "FAIL"
  storeId: "X1114B6L"
  orderId: "ORDER-3196fa3007bc4b6dab8",
  message: "Платеж не найден",
  signature: "2CnBRCAqV/BfNghrHUvHjEcGJZk="
}

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

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

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

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

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