Уведомления об операциях

Уведомления об операциях — это уведомления мерчанту о статусе выполнения платежа. На основании этих уведомлений магазин должен предоставлять покупателю услугу или товар.

Чтобы настроить уведомления:

1. В личном кабинете интернет-эквайринга перейдите в раздел Магазины.
2. На вкладке Терминалы нажмите Настроить и выберите нужный вариант получения уведомлений — почта, HTTP(S) или оба варианта.

Вы можете получать уведомления не только о статусах платежа — также есть уведомления о привязке карты, фискализации и привязке счета по QR.

Уведомления о платеже (NotificationPayment)

После проведения платежа через вызов метода Инициировать платеж вам будет отправлена информация о статусе платежа.

На электронную почту

Т‑Бизнес будет присылать письма с уведомлениями об успешных платежах в статусе CONFIRMED.

По HTTP(S)

При вызове методов:

• Подтвердить списание и Отменить платеж — уведомление с информацией об операции отправляется через POST‑запрос на адрес NotificationURL.

• Подтвердить платеж:

  • При двухстадийной оплате — уведомление с информацией об операции отправляется через POST‑запрос на адрес NotificationURL.

  • При одностадийной оплате — уведомление синхронно отправляется на ваш сайт на адрес NotificationURL и ждет ответа в течение 10 секунд. После получения или неполучения ответа сервис переадресует покупателя на SuccessURL или FailURL.

    Для метода Автоплатеж логика такая же, но он не перенаправляет покупателя на SuccessURL или FailURL.

• Привязать карту — уведомление синхронно отправляется на ваш сайт на адрес NotificationURL и ждет ответа в течение 10 секунд. После получения или неполучения ответа сервис переадресует покупателя на SuccessAddCardURLили FailAddCardURL.

Если в NotificationURL используются порты, можно использовать порт 443 (HTTPS).

Дополнительные параметры

Чтобы включить дополнительные параметры DATA, обратитесь к своему персональному менеджеру.

В уведомлениях можно получать дополнительные параметры. Для этого передайте объект DATA с нужными параметрами из списка ниже. В ответе вернется параметр Data — учитывайте регистр.

Параметр	Значение
description	Описание.
name	ФИО.
order_number	Идентификатор заказа.
paymentId	Идентификатор платежа.
source	Способ оплаты.
phone	Телефон.
terminalKey	Идентификатор терминала.

Чтобы получать POST‑запросы со статусами платежа, укажите URL в настройках терминала.

Ответ на HTTP(s)-уведомление

При успешной обработке уведомления вам нужно вернуть ответ HTTP CODE = 200 с телом сообщения OK — без тегов, заглавными английскими буквами.

Если ответ OK не получен, уведомление считается неуспешным. Сервис будет повторно отправлять его раз в час в течение 24 часов, а затем раз в сутки в течение месяца. Если за это время оно так и не будет доставлено, уведомление будет перемещено в архив.

Уведомления хранятся в архиве один год. В течение этого времени вы можете запросить их повторную отправку.

Уведомления о привязке (NotificationAddCard)

Для мерчантов со своей платежной формой.

После привязки карты через метод Привязать карту вам будет отправлена информация о статусе привязки.

Уведомления о фискализации (NotificationFiscalization)

Такие уведомления не отправляются, если вы работаете по схеме интеграции «Маркетплейс».

При подключенной онлайн-кассе по результату фискализации вам будет отправлено уведомление с фискальными данными.

Уведомления о статусе привязки счета по QR (NotificationQr)

Такие уведомления будут приходить только по статусам ACTIVE и INACTIVE.

После успешной привязки счета по QR вам будет отправлена информация о статусе привязки счета и подпись запроса.

Проверить токен уведомлений

При получении уведомления и перед его обработкой проверьте токен:

1. Соберите массив всех обязательных передаваемых параметров для конкретного метода в виде пар ключ:значение, кроме параметра Token:

   [{"TerminalKey": "1234567890DEMO"},{"OrderId": "000000"},{"Success": "true"},{"Status": "AUTHORIZED"},{"PaymentId": "0000000"},{"ErrorCode": "0"},{"Amount": "1111"},{"CardId": "000000"},{"Pan": "20000******0000"},{"ExpDate": "1111"},{"RebillId": "000000"}]

2. Добавьте в массив пару {"Password": "Значение пароля"}. Пароль можно найти в личном кабинете интернет-эквайринга.

   [{"TerminalKey": "1234567890DEMO"},{"OrderId": "000000"},{"Success": "true"},{"Status": "AUTHORIZED"},{"PaymentId": "0000000"},{"ErrorCode": "0"},{"Amount": "1111"},{"CardId": "000000"},{"Pan": "20000******0000"},{"ExpDate": "1111"},{"RebillId": "000000"},{"Password": "11111111111"}]

3. Отсортируйте массив по алфавиту по ключу:

   [{"Amount": "1111"},{"CardId": "000000"},{"ErrorCode": "0"},{"ExpDate": "1111"},{"OrderId": "000000"},{"Pan": "200000******0000"},{"Password": "11111111111"},{"PaymentId": "0000000"},{"RebillId": "000000"},{"Status": "AUTHORIZED"},{"Success": "true"},{"TerminalKey": "1234567890DEMO"}]

4. Конкатенируйте только значения пар в одну строку:

   111100000001111000000200000******0000111111111110000000000000AUTHORIZEDtrue1234567890DEMO

5. Примените к строке хеш-функцию SHA-256 (с поддержкой UTF-8):

   9b20300c4db1cc89e55dba5062497f135420cc5d93038d7e0a42537a1a36fcc5