/
Уведомления

Уведомления

Owned by Алексей Федоров (Unlicensed)
Last updated: Apr 19, 2024 by Anton Sukhorukov
2 min read

Описание: Уведомление — HTTP-запрос от системы к вашему сайту. Подобные запросы также называют callback или webhook. В системе предусмотрены информирования об успешных и неуспешных платежах.

Для возможности получения таких уведомлений необходимо указать URL и подпись в Dashboard → Настройки.

Правило генерации подписи – должна содержать 12 символов (Заглавные, строчные, цифры и спецсимволы).

В механизме есть ретрай на доставку. Если система CloudTips не сможет соединиться с сервером партнера или получит некорректный ответ, либо ответ с кодом, отличным от нуля, то будет совершено 100 попыток доставить webhook с интервалом между повторами в минутах: 1, 2, 5, 10, 30. Тайм-аут ожидания ответа - 30 секунд.

В механизме есть подпись запроса. Webhook содержит HTTP-заголовок X-Content-HMAC, в котором находится проверочное значение запроса, вычисленное с помощью алгоритма HMAC (

https://ru.wikipedia.org/wiki/HMAC ). Если партнеру необходимо проверять подлинность и целостность webhook, то он может вычислить проверочное значение на своей стороне и сравнить с тем, что пришло в запросе. Совпадение подтверждает, что webhook был отправлен от системы CloudTips и пришел к партнеру в оригинальном виде.

Особенности:
Webhook отправляется методом POST;
При вычислении HMAC следует использовать кодировку UTF8;
Хэш вычисляется функцией SHA256;
В качестве ключа используется секрет, который задается на стороне СТ и сообщается вам;
Вычисленное значение передается в кодировке base64.

Список актуальных ip адресов, с которых система отправляет уведомления, находится по адресу https://developers.cloudpayments.ru/#proverka-uvedomleniy

Тип: POST

Запрос:

Наименование

Тип

Обязательность

Описание

Наименование

Тип

Обязательность

Описание

success

bool

Да

успешность транзакции

layoutid

String

Да

Уникальный идентификатор страницы оплаты получателя

amount

Double

Да

Сумма чаевых

payerfee

Double

Да

Сумма комиссии с платящего

currency

String

Да

Валюта чаевых

invoiceid

String

Нет

Идентификатор переданный ТСП

transactionid

String

Да

Уникальный идентификатор транзакции

name

String

Нет

Имя получателя

createddate

String

Да

Дата транзакции

ipaddress

String

Да

Ip адрес платящего

cardtype

String

Нет

Платежная система карты: Visa, Mastercard, Maestro или “МИР”

Пример запроса:

Headers: content-type application/x-www-form-urlencoded x-content-hmac SLmMltlMuBQaOho8O30DKPmNg4WZrsFOOSTmU9s0+Kw= Body: success=True&layoutid=ad1c4d01&amount=53.8&currency=RUB&invoiceid=&transactionid=1737884985&name=&payerfee=3.8&createddate=2023-06-19T15%3a07%3a23.4490000Z&ipaddress=46.138.90.154&cardtype=Visa

Пример ответа:

В ответ на запрос система ожидает получить ответ в JSON-формате с обязательным параметром code: (200 StatusCode)

{"code":0}

В противном случае будет переотправка уведомления по правилам, описанным выше

Related content