11.3. fraudwall_learn. Получение платежей, исполненных в АБС

fraudwall_learn используется для получения информации о платежах, исполненных в АБС (как созданных клиентами банка, так и поступивших извне на счета клиентов банка).

11.3.1. Описание полей структуры fraudwall_learn

Таблица 20. Перечень полей fraudwall_learn

Поле Тип данных Описание
updated ДАТА ВРЕМЯ

Дата и время исполнения документа в АБС.

Примечание

Если есть проблемы с нагрузкой на СУБД при работе с данной VIEW, это поле может содержать только дату (без учета времени), т.е. часы, минуты и секунды всегда равны 00:00:00

abs_date ДАТА ВРЕМЯ

дата исполнения платежа в АБС

Примечание

Данное поле является опциональным и создается только в том случае, если нужно учесть индекс по дате исполнения платежа в АБС. В остальных случаях его создавать не нужно.

device текст

строка, содержащая информацию об идентификаторах устройства клиента, с которого была работа с документом (например, перечень обнаруженных MAC-адресов, IMEI и т.д.). Если неизвестно, можно возвращать пустую строку.

Наименование идентификаторов: mac - MAC-адрес сетевой карты, appid - уникальный ID моб. приложения на моб. устройстве, serial-number - уникальный серийный номер моб. аппарата, imei - IMEI-номер моб. устройства, imsi - IMSI-номер SIM-карты, iccid - уникальный идентификационный номер SIM-карты в международном формате. Если у Вашей системы ДБО есть также свой цифровой отпечаток устройства клиента, необходимо сообщить об этом нам, м.б. выделено уникальное наименование идентификатора

Примечание

Пример такой строки:

mac="00:11:22:33:44:55" mac="00:11:22:33:44:66" imei="123456789012345"

docid текст или число Идентификатор документа в анализируемой системе
docnumber текст или число Поле документа «Номер документа».
docdate ДАТА ВРЕМЯ Поле документа «Дата документа».

Внимание

Обратите внимание, что тип данных этого поля - ДАТА ВРЕМЯ

from_id текст или число

Идентификатор клиента в анализируемой системе, которому принадлежит расчетный счет плательщика

Примечание

Если такой информации нет, или же расчетный счет плательщика открыт в другом банке, можно возвращать NULL

from_name текст Поле документа «Наименование плательщика»
from_inn текст Поле документа «ИНН плательщика»
from_account текст Поле документа «расчетный счет плательщика»
from_bic текст Поле документа «БИК банка плательщика»
from_bank текст

Наименование банка, соответствующего БИК банка плательщика

Примечание

Можно всегда возвращать NULL - в этом случае значение будет браться из встроенного справочника банков РФ

from_city текст

Город, соответствующий банку плательщика

Примечание

Можно всегда возвращать NULL - в этом случае значение будет браться из встроенного справочника банков РФ

to_id текст или число

Идентификатор клиента в анализируемой системе, которому принадлежит расчетный счет получателя

Примечание

Если такой информации нет, или же расчетный счет получателя открыт в другом банке, можно возвращать NULL

to_name текст Поле документа «Наименование получателя»
to_inn текст Поле документа «ИНН получателя»
to_account текст Поле документа «расчетный счет получателя»
to_bic текст Поле документа «БИК банка получателя»
to_bank текст

Наименование банка, соответствующего БИК банка получателя

Примечание

Можно всегда возвращать NULL - в этом случае значение будет браться из встроенного справочника банков РФ

to_city текст

Город, соответствующий банку получателя

Примечание

Можно всегда возвращать NULL - в этом случае значение будет браться из встроенного справочника банков РФ

currency текст или число

3-х буквенный или 3-х числовой код валюты платежа

amount число с 2 знаками после запятой

Поле документа «Сумма платежа» (в валюте currency)

Примечание

При отсутствии или пустом значении поля currency валюта платежа берется из 20-значного счета получателя, а при его отсутствии - из 20-значного счета плательщика

purpose текст Поле документа «Назначение платежа»
kbk текст 20-значный код КБК (заполняется только для бюджетных платежей, у остальных платежей – значение NULL)
from_phone текст

Значение идентификатора телефона плательщика. Поле необязательное (нужно только если проверяются и операции СБП). Если операция не СБП - может быть NULL.

Примечание

Пример: 0079101234567 (из ЭБД {21} формата сообщения СБП (в случае ЭБД {46}= MTEL))

to_phone текст

Значение идентификатора телефона получателя. Поле необязательное (нужно только если проверяются и операции СБП). Если операция не СБП - может быть NULL.

Примечание

Пример: 0079101234567 (из ЭБД {20} формата сообщения СБП (в случае ЭБД {47}= MTEL))

to_paygate_dboid текст Идентификатор поставщика услуг в ДБО (цифровой идентификатор уникальной связки "поставщик услуги -тип услуги" (например, идентификаторы для услуг Ростелеком-интернет, Ростелеком-телевидение и т.д.)) - опционально, значение может быть пустым
to_paygate_account текст Номер лицевого счета, номер кошелька, номер телефона или иной идентификатор клиента в системе поставщика услуг - опционально, значение может быть пустым

11.3.2. Проверка, поддерживает ли поле UPDATED часы, минуты и секунды

Назначение:

Данный запрос проверяет, поддерживает ли поле updated структуры fraudwall_learn время с точностью до минут или секунд (если нет, то возвращаемое время всегда 00:00:00). Запрос выполняется однократно, если ранее такой информации не было.

Когда выполняется запрос:

Однократно при запуске процесса FraudWall (если ранее не было установлено, что updated поддерживает минуты и секунды).

Входные параметры для запроса:

updated >= текущие сутки 00:00:00 И docdate >= текущие сутки 00:00:00 

Если структура поддерживает abs_date, то дополнительно в запросе указывается:

И abs_date >= текущие сутки 00:00:00

Результат выполнения запроса:

Возвращает от 1 до максимум 10 значений updated, соответствующих исполненным платежам за текущие сутки. Если хотя бы одно из полученных значений updated содержит минуты или секунды, значит, поле updated их поддерживает.

11.3.3. Получение реквизитов платежей, исполненных в АБС за текущий день

Назначение:

Данный запрос получает реквизиты платежей, которые сегодня были исполнены в АБС.

Когда выполняется запрос:

При выполнении хотя бы одного запроса, FraudWall оценивает время, которое он выполнялся внешней системой - если запрос выполняется более 15 секунд, он считается тяжелым.

Если в свойствах сайта значение параметра "Проверка работоспособности механизма АБС блокировки подозрительных документов" не в значении "отсутствует", FraudWall будет делать запрос загрузки платежей, исполненных за текущий день, каждые 10 минут, вне зависимости от того, является запрос тяжелым или нет.

Если этот параметр стоит в значении "отсутствует", запрос получения исполненных платежей за текущий день делается только если в свойствах сайта значение параметра "Реквизиты исполненных (даже не вызывавших подозрения) платежей хранить" выставлено от 1 и более дней. При этом учитывается также, является ли запрос тяжелым или нет - если запрос тяжелый (т.е. выполняется долго), он запускается однократно ночью, если не тяжелый - то каждые 15 минут.

Входные параметры для запроса:

updated <= текущие сутки 23:59:59

Если поле updated поддерживает минуты и секунды (см. 11.3.2 «Проверка, поддерживает ли поле UPDATED часы, минуты и секунды»), то также указывается

И updated >= максимальное время updated текущих суток, полученное при предыдущем запросе

Если же updated возвращает только дату (без времени), то указывается

И updated >= текущие сутки 00:00:00

Если структура поддерживает abs_date, то:

И abs_date >= текущие сутки 00:00:00
И abs_date <= текущие сутки 23:59:59

Если структура не поддерживает abs_date, то:

И docdate >= текущие сутки 00:00:00 минус 14 суток
И docdate <= текущие сутки 23:59:59

Результат выполнения запроса:

Возвращает массив структур fraudwall_learn, соответствующий всем исполненным в АБС платежам согласно заданным критериям отбора.

Если updated поддерживает минуты и секунды, результат дополнительно должен быть отсортирован по возрастанию значения updated

Примечание

Если FraudWall получает информацию из анализируемой системы через VIEW fraudwall_learn, эту сортировку FraudWall автоматически добавляет при вызове SELECT, поэтому в коде VIEW fraudwall_learn сортировку добавлять не нужно.

Примечание

Обратите внимание, что для целей проверки платежей на ПОД/ФТ необходимо, чтобы возвращались не только платежи от клиентов банка, но и платежи на клиентов банка, в т.ч. получаемые из других банков.

11.3.4. Получение реквизитов платежей, исполненных в АБС, за предыдущие дни

Назначение:

Данный запрос получает реквизиты платежей, которые были исполнены в АБС за заданные сутки.

Когда выполняется запрос:

Получение платежей за предыдущие дни выполняется в следующих случаях:

  • запущен процесс обучения системы (т.е. предварительного построения статистики антифрода историей платежей за последние 2 года)

  • при автоматическом дообучении новыми исполненными платежами в процессе эксплуатации системы

При выполнении хотя бы одного запроса, FraudWall оценивает время, которое он выполнялся внешней системой - если запрос выполняется более 15 секунд, он считается тяжелым.

Процесс получения платежей за предыдущие дни запускается с учетом того, является запрос тяжелым или нет. Если запрос тяжелый (т.е. выполняется долго), то он вызывается в ночное время, если нет - то он может быть вызван и днем (но не чаще, чем 1 раз в 1 минуту).

Входные параметры для запроса:

FraudWall всегда запрашивает данные максимум за одни сутки (т.е. за заданную дату)

updated <= заданная дата 23:59:59

Если поле updated поддерживает минуты и секунды (см. 11.3.2 «Проверка, поддерживает ли поле UPDATED часы, минуты и секунды»), то:

И updated >= заданная дата с максимальным временем, полученным при предыдущем запросе

Если же updated возвращает только дату (без времени), то:

И updated >= заданная дата 00:00:00

Если структура поддерживает abs_date, то:

И abs_date >= заданная дата 00:00:00
И abs_date <= заданная дата 23:59:59

Если структура не поддерживает abs_date, то:

И docdate >= заданная дата 00:00:00 минус 14 суток
И docdate <= заданная дата 23:59:59

Результат выполнения запроса:

Возвращает массив структур fraudwall_learn, соответствующий всем исполненным в АБС платежам согласно заданным критериям отбора.

Если updated поддерживает минуты и секунды, результат дополнительно должен быть отсортирован по возрастанию значения updated

Примечание

Если FraudWall получает информацию из анализируемой системы через VIEW fraudwall_learn, эту сортировку FraudWall автоматически добавляет при вызове SELECT, поэтому в коде VIEW fraudwall_learn сортировку добавлять не нужно.

Примечание

Обратите внимание, что для целей проверки платежей на ПОД/ФТ необходимо, чтобы возвращались не только платежи от клиентов банка, но и платежи на клиентов банка, в т.ч. получаемые из других банков.