Перейти к содержанию

Уведомления по СКО


Система IntellectMoney отправляет уведомления (webhooks) о событиях по СКО на указанный URL-адрес. Отправка уведомлений необязательна и выполняется только по включённым событиям. Уведомления позволяют отслеживать изменение статуса СКО по событиям: создание, отмена, оплата, частичная оплата, захолдирование, возврат.

Настройка и приём уведомлений

  • Укажите URL-адрес для уведомлений в настройках магазина на вкладке "Подключение магазина" в поле "Result URL".
  • Укажите электронную почту в поле "E-mail для отправки писем" для сообщений об ошибке доставки уведомлений.
  • Включите нужные события на вкладке "Уведомления".
  • На указанном Result URL разместите обработчик, который:
    • Принимает форму уведомления и разбирает переданные параметры.
    • Верифицирует подпись в соответствии с сигнатурой указанной в параметре Hash, где полученная подпись, должна быть равна значению Hash. При несовпадении подписи, OK не возвращается.
    • При успешной верификации, отвечает статусом HTTP 200 и текстом OK (ровно две латинские буквы, без лишних символов и переводов строки) с заголовком ответа Content-Type: text/plain; charset=UTF-8.

Дополнительно разработчику

  • Отправка уведомлений на Result URL выполняется методом POST по HTTPS (рекомендуется), HTTP (не рекомендуется), двумя способами:
    • Напрямую с серверов IntellectMoney (исходящий IP: 62.122.184.254).
    • Через CDN-сервисы — исходный IP 62.122.184.254 будет передан в прокси-заголовках (например, X-Forwarded-For).
  • Кодировку формы уведомления можно изменить в расширенных настройках магазина на вкладке "Подключение магазина". Используйте ту же кодировку при расчёте Hash.
  • При отсутствии корректного ответа (HTTP 200 и текст OK) система выполняет повторные отправки (retry) одного и того же события в течение нескольких дней и дополнительно направляет письмо на электронную почту об ошибке получения уведомления.
  • Очерёдность доставки разных событий не гарантируется — обработчик должен быть устойчив к переупорядочиванию. Обеспечьте идемпотентность: фиксируйте обработку по уникальному идентификатору события (СКО), чтобы исключить повторную обработку.
  • Для отладки используйте личный кабинет.

Форма уведомления

Параметр Свойства Описание
EshopId INT REQUIRED max 6 Номер магазина.
Можно найти в личном кабинете, в разделе магазины.
PaymentId LONG REQUIRED 3xxxxxxxxx Номер СКО.
OrderId STRING REQUIRED max 50 Номер покупки.
Внутренний номер покупки из вашей системы (интернет-магазина).
По умолчанию в расширенных настройках магазина на вкладке "Подключение магазина" включена опция "Принимать только уникальный номер покупки", что позволяет легко идентифицировать СКО.
EshopAccount LONG REQUIRED max 10 Номер счета магазина.
На данный счет будут зачислены средства после оплаты покупки.
ServiceName STRING OPTIONAL max 1024 Назначение платежа.
Служит для описания товара или услуги.
RecipientOriginalAmount DECIMAL REQUIRED max 13 Исходная сумма платежа.
Минимальное значение 1.00.
Формат: десятичное число с двумя знаками после точки.
RecipientAmount DECIMAL REQUIRED max 13 Сумма платежа.
Минимальное значение 1.00.
Формат: десятичное число с двумя знаками после точки.
RefundAmount DECIMAL OPTIONAL max 13 Сумма возврата.
Минимальное значение 1.00.
Формат: десятичное число с двумя знаками после точки.
RecipientCurrency STRING REQUIRED const Валюта платежа.
Допустимые значения:
  1. RUB и RUR - для платежей в рублях.
  2. TST - для тестовых платежей.
  3. USD - для платежей в американских долларах.
  4. EUR - для платежей в евро.
PaymentStatus INT REQUIRED const Статус платежа.
Допустимые значения:
  1. 3 - создан, отправляется при создании СКО.
  2. 4 - отменен, отправляется по истечении срока действия СКО или отмене СКО через личный кабинет, либо API.
  3. 5 - оплачен, отправляется при полной оплате СКО.
  4. 6 - захолдирован, отправляется при временной блокировке денежных средств на банковской карте покупателя по СКО.
  5. 7 - частично оплачен, отправляется при частичной оплате СКО.
  6. 8 - возврат, отправляется при возврате денежных средств по СКО.
UserName STRING OPTIONAL max 255 Имя покупателя.
UserEmail STRING REQUIRED max 100 Электронная почта покупателя.
PaymentData STRING REQUIRED yyyy-MM-dd HH:mm:ss Дата последнего события по СКО.
PayMethod STRING OPTIONAL const Способ оплаты СКО.
Допустимые значения:
  • Acquiring - банковская карта.
  • TestAcquiring - тестовая банковская карта.
  • PremiumCardAcquiring - премиум банковская карта.
  • ForeignAcquiring - иностранная банковская карта.
  • BNPL - рассрочка.
  • Sbp - СБП.
  • MirPay - Mir Pay.
  • SberPay - SberPay.
  • YandexPay - Яндекс Пэй.
  • GazpromPay - Gazprom Pay.
  • QiwiWallet - Киви кошелёк.
ShortPan STRING OPTIONAL max 22 Короткий номер банковской карты (первые шесть и последние четыре цифры банковской карты).
Передача параметра в форме, предоставляется по запросу через менеджера.
Country STRING OPTIONAL max 3 Страна, в которой была выпущена банковская карта.
Формат: ISO 3166-1 alpha-3.
Передача параметра в форме, предоставляется по запросу через менеджера.
Bank STRING OPTIONAL max 100 Банк-эмитент.
Банк, выпустивший пластиковую карту.
Передача параметра в форме, предоставляется по запросу через менеджера.
IpAddress STRING OPTIONAL max 15 IPv4-адрес покупателя.
Передача параметра в форме, предоставляется по запросу через менеджера.
SecretKey STRING OPTIONAL max 50 Секретный ключ магазина.
Указан в настройках магазина на вкладке "Подключение магазина".
По умолчанию секретный ключ отсутствует — его необходимо указать самостоятельно.
Передача параметра в форме, предоставляется по запросу через менеджера.
GatewayName STRING OPTIONAL max 50 Шлюз.
RecurringState STRING CONDITION const Статус операции по расписанию.
Допустимые значения:
  • Activated - активирован (исходный СКО оплачен).
  • Deactivated - деактивирован, операцию по расписанию создать нельзя.
  • Payed - оплата завершена, операция по расписанию выполнена.
  • Error - ошибка обработки операции.

Условия:
  • Передается для операции по расписанию.
  • Не передается в остальных случаях.
SourceInvoiceId LONG CONDITION 3xxxxxxxxx Номер исходного СКО.
Условия:
  • Передается для операции по расписанию.
  • Не передается в остальных случаях.
Hash STRING REQUIRED Подпись данных запроса.
Выполняет две ключевые функции:
  1. Целостность данных - защиту от изменений: подпись гарантирует, что информация в запросе не была модифицирована при передаче.
  2. Аутентификацию отправителя - подтверждение, что запрос создан доверенным сервисом (используется секретный ключ магазина, доступный только отправителю и получателю).
Подробнее об использовании контрольной подписи.

Сигнатура подписи:
EshopId::OrderId::ServiceName::EshopAccount::RecipientAmount::RecipientCurrency::PaymentStatus::UserName::UserEmail::PaymentData::SecretKey
text/plain; charset=UTF-8
OK