Колбек

URL

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

Тип запиту

POST

Відповідь від сервісу надходить у CallBack запит на вказаний responseUrl при створенні платежу

Успешна відповідь

{
    storeId: "sdfgw456dsfv23",
    orderId: "ORDER-3196fa3007bc4b6dab8",
    paymentState: "SUCCESS",
    message: "Текст договору",
    signature: "2CnBRCAvHjEcGJZk="
}

Відповідь з помилкою

{
    storeId: "sdfgw456dsfv23"
    orderId: "ORDER-3196fa3007bc4b6dab8"
    paymentState: "FAIL",
    message: "Платіж не знайден",
    signature: "2CnBRCAqvHjEcGJZk="
}

Розрахунок сигнатури для відповіді

SIGNATURE = encodeBase64 ( SHA1 ( password + storeIdentifier + orderId + paymentState + message + password )

• encodeBase64 () - Функція зашифровує рядок у форматі BASE64;

• SHA1 () - Стандартна хеш-функція SHA-1 повинна повертати бінарні дані;

• "+" - Конкатенація текстового рядка.

Параметр	Значення
password	Пароль вашого магазину
storeId*	Ідентифікатор магазину
orderId	Унікальний номер платежу
paymentState	Статус угоди
message	У разі помилки містить повідомлення помилки
password	Пароль вашого магазину

* storeId для json або storeIdentifier для xml

Опис статусів платежу

Состояние	Опис
CREATED	Платіж створено
CANCELED	Платіж скасовано (клієнтом)
SUCCESS	Платіж успішно здійснено
FAIL	Помилка під час створення платежу
CLIENT_WAIT	Очікування оплати клієнта
OTP_WAITING	Підтвердження клієнтом ОТП пароля
PP_CREATION	створення контракту для платежу
LOCKED	Платіж підтверджений клієнтом і чекає на підтвердження магазином.

В адмінпанелі в налаштуваннях магазину є опція "Додаткові параметри відповіді успішного платежу". При її активації в колбеку приходитиме об'єкт info, в якому будуть параметри відповіді успішного платежу для виконання норм Наказу Міністерства Фінансів (посилання)

1. cardMask (string), номер картки у форматі 1234 44 ** 5678

2. bankName (string), банк. За замовчуванням PB.

3. authCode (string), код авторизації

4. rrn (string), код РРН

5. paymentSystem (string), платіжна система. На 05.08.21 можливі Visa або MC.

6. ownerName (string) - власник картки-платіжного засобу.

7. terminal (string) - термінал. Наприклад, X1111RJ2.

8. acquirer (string) - Наименування банка-еквайєра

приклад відповіді з додатковими параметрами

{
	"orderId": "7026121",
	"paymentState": "SUCCESS",
	"signature": "C6geXmBAeiPzuVA7olrZs+B3nZw=",
	"info": {
		"cardMask": "5168 74 ** 1111",
		"bankName": "PrivatBank",
		"authCode": "210810",
		"rrn": "210810154732",
		"paymentSystem": "Mastercard",
		"ownerName": "ТЕСТ АРТЕМ ЮРІЙОВИЧ",
		"terminal": "X1111RJ2",
		"acquirer": "ПРИВАТБАНК"
	},
	"message": "Текст договору",
	"storeId": "01841655273A4951BBAF"
}

ВАЖЛИВО!

Перевірте конфігурації на вашому фаєрволі, повинні бути додані до списку довірених IP-адрес:

пулы

217.117.66.32...217.117.66.63

217.117.68.32...217.117.68.63

ip 217.117.64.236 и 217.117.68.236

3.126.39.150

3.71.149.227

3.64.115.193

3.72.171.27

3.71.155.135

18.158.71.228

217.117.76.0/24