Повернення платежу
URL
https://payparts2.privatbank.ua/ipp/v2/payment/decline
Тип запиту
POST
Headers
Назва | Значення |
Accept: | application/json; |
Accept-Encoding: | UTF-8; |
Content-Type: | application/json; charset=UTF-8; |
Body запроса
Описание полей
Поле | Формат | Опис | Обов'язкове |
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 - Операція проведена успішно, FAIL - Виникла помилка |
storeId | Ідентифікатор магазину |
orderId | Унікальний номер платежу |
message | Повідомлення про помилку |
signature | Підпис запиту |
Розрахунок сигнатури для відповіді
SIGNATURE = encodeBase64 ( SHA1 ( password
+ state
+ storeId
+ orderId
+ message
+ password
))
encodeBase64 () - Функція зашифровує рядок у форматі BASE64;
SHA1 () - Стандартна хеш-функція SHA-1 повинна повертати бінарні дані;
"+" - Конкатенація текстового рядка.
Параметр | Значення |
password | Пароль магазину |
state | Результат відпрацювання запиту |
storeId | Ідентифікатор магазину |
orderId | Унікальний номер платежу |
message | У разі помилки містить повідомлення помилки |
password | Пароль вашого магазину |
Last updated