Возврат платежа

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