Получение результата сделки (асинхронный коллбэк)

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 Платеж подтвержден клиентом и ожидает подтверждение магазином.

ВАЖНО!

Проверьте конфигурации на вашем фаерволе, должны быть добавлены в список доверенных 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