Пошук повернень по транзакціям

URL

https://payparts2.privatbank.ua/ipp/terms/get/statements/for/returnspayparts2.privatbank.ua

Тип запиту

POST

Headers

назва	значення
Accept	application/json;
Accept-Encoding	UTF-8;
Content-Type	application/json; charset=UTF-8;

Body запиту

{
  "signature": "",
  "dateTo": "20230415",
  "storeId": "",
  "dateFrom": "20230410"
}

опис полів

назва	опис	обов`язковість
dateFrom	дата початку періоду,string	так
dateTo	дата кінця періоду,string	так
storeId	ідентіфікатор магазину,string	так
signature	сигнатура,string	так

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

SIGNATURE - підпис запиту, обов'язковий параметр ,розрахується за формулою: encodeBase64 ( SHA1 ( password + storeId + dateFrom + dateTo + password )), де:

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

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

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

назва	значення
password	Пароль вашого магазину
storeId	Ідентифікатор магазину
dateFrom	Дата початку періоду
dateTo	Дата закінчення періоду

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

{
	"statementsForReturnsResponses": [{
			"dogovor": "1213231313",
			"store": "магазин",
			"orderId": "1121218",
			"refundsSum": 2999.0,
			"refundsDate": 2023-04-15 11:43:40,
			"refundsСomis": 150.85
		},
		{
			"dogovor": "24545",
			"store": "магазин",
			"orderId": "54545",
			"refundsSum": 4620.0,
			"refundsDate": 2023-04-15 11:43:40,
			"refundsСomis": 232.39
		},
		{
			"dogovor": "45555555",
			"store": "магазин",
			"orderId": "14545554",
			"refundsSum": 6802.0,
			"refundsDate": 2023-04-15 11:43:40,
			"refundsСomis": 478.18
		}
	]
}

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

{
	"state": "FAIL",
	"message": "The signature isn't valid"
}

Опис полів