API "Оплата Частями

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

Last updated