A
A
API "Оплата Частями в Интернете"
Search…
A
A
API "Оплата Частями в Интернете"
С чего начать?
Тестовые данные
ЧаВо
Демо-магазин
Sandbox
Плагины
Платежи
Возврат платежа
Получение статуса платежа
Добавление описания платежа
Генерация QR кода
Агентам - маркетплейсы, платежные агрегаторы
Выписки
Калькулятор
Виджет для получения лимита
Брендирование
Инвойсы
Тренажер покупок в Оплату частями
Инструкция по Личному кабинету
Powered By
GitBook
Возврат платежа
URL
https://payparts2.privatbank.ua/ipp/v2/payment/decline
Тип запроса
POST
Заголовки
Название
Значение
Accept:
application/json;
Accept-Encoding:
UTF-8;
Content-Type:
application/json; charset=UTF-8;
Тело запроса
1
{
2
"storeId"
:
“asfdasdfasdf"
,
3
"orderId"
:
"ORDER-3196fa3007bc4b6dab8"
,
4
"amount"
:
300.00
,
5
"recipientId"
:
"qwerty1234"
,
6
"signature"
:
"vBh0dOhvJuUz1tKOrNVZy/Q34zo="
7
}
Copied!
Описание полей
Поле
Формат
Описание
Обязательное
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
Пароль вашего магазина
Успешный ответ
1
{
2
state
:
"SUCCESS"
,
3
storeId
:
"X1114B6L"
,
4
orderId
:
"ORDER-3196fa3007bc4b6dab8"
,
5
signature
:
"2CnBRCAqV/BfNghrHUvHjEcGJZk="
6
}
Copied!
Ответ с ошибкой
1
{
2
state
:
"FAIL"
3
storeId
:
"X1114B6L"
4
orderId
:
"ORDER-3196fa3007bc4b6dab8"
,
5
message
:
"Платеж не найден"
,
6
signature
:
"2CnBRCAqV/BfNghrHUvHjEcGJZk="
7
}
Copied!
Описание полей
Состояние
Описание
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
Пароль вашего магазина
Previous
Отмена платежа
Next
Получение статуса платежа
Last modified
1yr ago
Copy link
Contents
URL
Тип запроса
Заголовки
Тело запроса
Описание полей
Расчет сигнатуры для запроса
Успешный ответ
Ответ с ошибкой
Описание полей
Расчет сигнатуры для ответа