Сообщение admi.010
Сообщение admi.010 должно соответствовать XSD схеме сообщения admi.010.001.02 стандарта ISO20022 и правилам заполнения документа, указанным в таблице ниже. Если поле не отмечено как опциональное, то оно является обязательным.
Нижеперечисленные параметры добавляются в рамках расширения состава данных:
Скор. балл определяется согласно документу «Параметры Единый QR (n)_V3.xlsx»:
Состав элементов сообщения admi.010:
0
StaticDataReport
StatcDataRpt
Результат запроса данных
1
MessageIdentification
MsgId
Идентификатор сообщения (формат должен соответствовать описанному в Генерация уникальных идентификаторов для сообщений)
2
ReportDetails
RptDtls
2.1
Type
Tp
Тип получаемых данных.
Должно принимать значение:
QR - для адаптационной модели;
QR_V2 - для целевой модели.
2.2
RequestReference
ReqRef
Сквозной идентификатор из запроса данных admi.009, указанный с ключом END_TO_END_ID (формат должен соответствовать описанному в Генерация уникальных идентификаторов для сообщений) . Соответствует значению HTTP заголовка end-to-end-id
2.3
ReportKey
RptKey
Массив
2.3.1
Key
Key
Может принимать значения:
QR
2.3.2
ReportData
RptData
Массив.
Информация в виде «ключ-значение»:
в теге <Nm> - передается ключ;
в теге <Val> - передается соответствующее указанному ключу значение.
Не допускается указывать один и тот же ключ дважды.
Список используемых ключей приведено в таблице ниже.
2.3.2.1
Name
Nm
Ключ (Upper Camel Case)
2.3.2.2
Value
Val
Значение
3
SupplementaryData
SplmtryData
Обязательный в случае успешного ответа (при QR_DATA_TYPE=002,004)
Дополнительные данные о мерчанте. Массив. Параметры запроса в виде «ключ-значение»:
- в теге <PlcAndNm> - передается ключ;
- в теге <Envlp> - передается соответствующее указанному ключу значение. Не допускается указывать один и тот же ключ дважды. Список используемых ключей приведен в таблице ниже.
3.1
PlaceAndName
PlcAndNm
Ключ
3.2
Envelope
Envlp
3.2.1
EnvlpValue
EnvlpValue
Значение
Список используемых ключей для сообщений admi.010:
MSG_CREATION_TIME
Дата и время создания сообщения, обязательный. Указывается в формате UTC (см. Формат даты и времени в бизнес сообщении (ISODateTime и ISODate)).
SENDER_PROVIDER_ID
Идентификатор банка отправителя запроса, обязательный. Идентификатор, присвоенный банку Системой (provider id) (см.Получение информации о банках и статусе API).
RECEIVER_PROVIDER_ID
Идентификатор банка получателя запроса, обязательный. Идентификатор, присвоенный банку Системой (provider id).
Определяется на основе {BANK_BASE_DOMAIN} из QR-кода (см.Получение информации о банках и статусе API).
ERROR_CODE
Информация об ошибке, (обязательный в случае ошибки). Возможные значения см. в Коды ошибок
условно обязательный
ERROR_DESCRIPTION
Описание ошибки, максимальная длина: 105 символов(обязательный в случае ошибки).
условно обязательный
QR_DATA_TYPE
Тип запрашиваемых данных, обязательное, если данные по QR_ID найдены успешно. Может принимать значения:
- 002 (оплата в рамках электронной коммерции, используется для операций типа C2B2E);
- 003 (возврат по проведенной оплате, используется для операций типа C2BR);
- 004 (оплата по QR-коду, используется для операций типа C2B2_V2 в рамках целевой модели);
- 005 (возврат по проведенной оплате, используется для операций типа C2BR_V2 в рамках целевой модели)
QR_TYPE
Тип QR кода, обязательный в случае успешного ответа при QR_DATA_TYPE=002, 004. Принимает значения:
- STATIC - для статического QR-кода
- DYNAMIC - для динамического QR-кода
POS_ID
Идентификатор торговой точки в системе банка-эквайера. Используется для идентификации торговой точки, к которой относится платеж, максимальная длина: 35 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=002, 004.
BIC
БИК банка поставщика товара, работы или услуги (бенефициара), 8 символов (латинский алфавит и цифры), обязательный в случае успешного ответа при QR_DATA_TYPE=002,004.
ACCOUNT_NUMBER
IBAN счета поставщика товара, работы или услуги (бенефициара), обязательный в случае успешного ответа при QR_DATA_TYPE=002,004. Шаблон:^[0-9A-Z]{20}$
MCC
4-значный код категории продавца, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004.
COMPANY_NAME
Наименование поставщика товара, работы или услуги, максимальная длина: 140 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004
COUNTRY_OF_RESIDENCE
Код страны резидентства поставщика товара, работы или услуги, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004. Значение в соответствии с ISO 3166-1 alpha 2, для Казахстана - «KZ».
CITY
Город физического местонахождения поставщика товара, работы или услуги, максимальная длина: 35 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004
CURRENCY
Код валюты (буквенный), принимает значение KZT, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004.
AMOUNT
Сумма платежа, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004 для динамических QR-кодов и статических QR-кодов с фиксированной суммой, не используется для статических QR-кодов по операциям с вводом суммы на стороне клиента. Не должно превышать 100 000 000 000 00, должна передаваться в тиын (см. Правило передачи значений денежных сумм).
KNP
Код назначения платежа, 3 символа (цифры), обязательный в случае успешного ответа при QR_DATA_TYPE=002,004.
KNP_MESSAGE
Описание КНП, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004. Длина: до 140 символов.
BENEFICIARY_CODE
Код бенефициара, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004. Значение этого поля состоит из двух цифр: первая цифра указывает признак резидентства (1 или 2), вторая сектор экономики (принимает значение от 1 до 9).
SME
Признак того, что поставщика товара, работы или услуги является представителем малого или среднего бизнеса, обязательный в случае успешного ответа при QR_DATA_TYPE=002,004. Принимает значения: значение: 0 – не является МСБ, 1 – является МСБ.
MERCHANT_CHANNEL
Канал транзакции. Трехзначная цифра. Значения каналов транзакции приведены в таблице ниже.
Опционально
QR_ID
Идентификатор QR-кода, должен соответствовать значению, указанному в admi.009 с ключом QR_ID, шаблон: [0-9A-Za-z_=-]{8,50}.
COMPANY_ID
ИИН/БИН поставщика товара, работы или услуги , обязательный в случае успешного ответа при QR_DATA_TYPE=002,004.
COMPANY_FULL_NAME
Полное наименование мерчанта
PARTNER_BANK
Банк партнера
BUSINESS_LEGAL_FORM
Организационно правовая форма бизнеса(ИП/ТОО)
MERCHANT_ID
Идентификатор мерчанта (ТСП) в системе банка-эквайера. Используется для идентификации получателя платежа.
TERMINAL_ID
Идентификатор терминала в системе банка-эквайера. Используется для идентификации терминала, через который выполняется платеж.
DEVICE_IP
IP устройства для динамичного/статичного
SALES_POINT_ADDRESS
Адрес точки продаж
PARTNER_CONNECTION_DATE
Дата подключение партнера
QR_GENERATION_DATETIME
Дата и время формирования QR.
Указывается в формате UTC (см. параграф 2 главы 2)
CEO_IIN
ИИН первого руководителя
SCORE_SALES_DAYS_COUNT_ONE_DAY
Скор балл для параметра «кол-во дней с продажами за 1 день»
SCORE_SALES_DAYS_COUNT_SEVEN_DAYS
Скор балл для параметра «кол-во дней с продажами за 7 дней»
SCORE_SALES_DAYS_COUNT_FOURTEEN_DAYS
Скор балл для параметра «кол-во дней с продажами за 14 дней»
SCORE_SALES_DAYS_COUNT_ONE_MONTH
Скор балл для параметра «кол-во дней с продажами за 1 месяц»
SCORE_SALES_DAYS_COUNT_THREE_MONTHS
Скор балл для параметра «кол-во дней с продажами за 3 месяца»
SCORE_SALES_DAYS_COUNT_SIX_MONTHS
Скор балл для параметра «кол-во дней с продажами за 6 месяцев»
SCORE_SALES_DAYS_COUNT_TWELVE_MONTHS
Скор балл для параметра «кол-во дней с продажами за 12 месяцев»
SCORE_CARD_SALES_SHARE_CURRENT_DAY
Скор балл для параметра «доля продаж в сумме картой за текущий день»
SCORE_CARD_SALES_SHARE_ONE_DAY
Скор балл для параметра «доля продаж в сумме картой за 1 день»
SCORE_CARD_SALES_SHARE_SEVEN_DAYS
Скор балл для параметра «доля продаж в сумме картой за 7 дней»
SCORE_CARD_SALES_SHARE_FOURTEEN_DAYS
Скор балл для параметра «доля продаж в сумме картой за 14 дней»
SCORE_CARD_SALES_SHARE_ONE_MONTH
Скор балл для параметра «доля продаж в сумме картой за 1 месяц»
SCORE_CARD_SALES_SHARE_THREE_MONTHS
Скор балл для параметра «доля продаж в сумме картой за 3 месяца»
SCORE_CARD_SALES_SHARE_SIX_MONTHS
Скор балл для параметра «доля продаж в сумме картой за 6 месяцев»
SCORE_CARD_SALES_SHARE_TWELVE_MONTHS
Скор балл для параметра «доля продаж в сумме картой за 12 месяцев»
SCORE_QR_SALES_SHARE_CURRENT_DAY
Скор балл для параметра «доля продаж в сумме QR за текущий день»
SCORE_QR_SALES_SHARE_ONE_DAY
Скор балл для параметра «доля продаж в сумме QR за 1 день»
SCORE_QR_SALES_SHARE_SEVEN_DAYS
Скор балл для параметра «доля продаж в сумме QR за 7 дней»
SCORE_QR_SALES_SHARE_FOURTEEN_DAYS
Скор балл для параметра «доля продаж в сумме QR за 14 дней»
SCORE_QR_SALES_SHARE_ONE_MONTH
Скор балл для параметра «доля продаж в сумме QR за 1 месяц»
SCORE_QR_SALES_SHARE_THREE_MONTHS
Скор балл для параметра «доля продаж в сумме QR за 3 месяца»
SCORE_QR_SALES_SHARE_SIX_MONTHS
Скор балл для параметра «доля продаж в сумме QR за 6 месяцев»
SCORE_QR_SALES_SHARE_TWELVE_MONTHS
Скор балл для параметра «доля продаж в сумме QR за 12 месяцев»
SCORE_SALES_DAYS_RATIO_2Y
Скор балл для параметра «соотношение дней с продажами к кол-ву дней с первой продажи за 2 года»
SCORE_AVG_PURCHASES_CURRENT_DAY
Скор балл для параметра «среднее кол-во покупок за текущий день»
SCORE_AVG_PURCHASES_ONE_DAY
Скор балл для параметра «среднее кол-во покупок за 1 день»
SCORE_AVG_PURCHASES_SEVEN_DAY
Скор балл для параметра «среднее кол-во покупок за 7 дней»
SCORE_AVG_PURCHASES_FOURTEEN_DAY
Скор балл для параметра «среднее кол-во покупок за 14 дней»
SCORE_AVG_PURCHASES_ONE_MONTH
Скор балл для параметра «среднее кол-во покупок за 1 месяц»
SCORE_AVG_PURCHASES_THREE_MONTHS
Скор балл для параметра «среднее кол-во покупок за 3 месяца»
SCORE_AVG_PURCHASES_SIX_MONTHS
Скор балл для параметра «среднее кол-во покупок за 6 месяцев»
SCORE_AVG_PURCHASES_TWELVE_MONTHS
Скор балл для параметра «среднее кол-во покупок за 12 месяцев»
SCORE_DAYS_SINCE_FIRST_SALE
Скор балл для параметра «кол-во дней с первой продажи»
SCORE_AVG_RECEIPT_CURRENT_DAY
Скор балл для параметра «средний чек на покупку за текущий день»
SCORE_AVG_RECEIPT_ONE_DAY
Скор балл для параметра «средний чек на покупку за 1 день»
SCORE_AVG_RECEIPT_SEVEN_DAYS
Скор балл для параметра «средний чек на покупку за 7 дней»
SCORE_AVG_RECEIPT_FOURTEEN_DAYS
Скор балл для параметра «средний чек на покупку за 14 дней»
SCORE_AVG_RECEIPT_ONE_MONTH
Скор балл для параметра «средний чек на покупку за 1 месяц»
SCORE_AVG_RECEIPT_THREE_MONTHS
Скор балл для параметра «средний чек на покупку за 3 месяца»
SCORE_AVG_RECEIPT_SIX_MONTHS
Скор балл для параметра «средний чек на покупку за 6 месяцев»
SCORE_AVG_RECEIPT_TWELVE_MONTHS
Скор балл для параметра «средний чек на покупку за 12 месяцев»
SCORE_TRANSACTIONS_COUNT_CURRENT_DAY
Скор балл для параметра «кол-во транзакции за текущий день»
SCORE_TRANSACTIONS_COUNT_ONE_DAY
Скор балл для параметра «кол-во транзакции за 1 день»
SCORE_TRANSACTIONS_COUNT_SEVEN_DAYS
Скор балл для параметра «кол-во транзакции за 7 дней»
SCORE_TRANSACTIONS_COUNT_FOURTEEN_DAYS
Скор балл для параметра «кол-во транзакции за 14 дней»
SCORE_TRANSACTIONS_COUNT_ONE_MONTH
Скор балл для параметра «кол-во транзакции за 1 месяц»
SCORE_TRANSACTIONS_COUNT_THREE_MONTHS
Скор балл для параметра «кол-во транзакции за 3 месяца»
SCORE_TRANSACTIONS_COUNT_SIX_MONTHS
Скор балл для параметра «кол-во транзакции за 6 месяцев»
SCORE_TRANSACTIONS_COUNT_TWELVE_MONTHS
Скор балл для параметра «кол-во транзакции за 12 месяцев»
DEVICE_TYPE
Тип устройства (POS терминал, мобильное приложение)
OS_TYPE
Операционная система (IOS/Android)
APP_LANGUAGE
Язык приложение\устройства
GEOLOCATION
Геолокация
SCORE_DAYS_SINCE_LAST_PASSWORD_CHANGE
Скор балл для параметра «Кол-во дней с последней смены пароля »
SCORE_DAYS_SINCE_NEW_DEVICE_LOGIN
Скор балл для параметра «Кол-во дней со входа с нового устройства»
DEVICE_SESSION_START_DATETIME
Дата и время открытия текущей сессии устройства.
Указывается в формате UTC (см. параграф 2 главы 2)
SCORE_SALES_COUNT_SINCE_SESSION_START
Скор балл для параметра «Кол-во продаж с начала сессии»
SCORE_AVG_RECEIPT_SINCE_SESSION_START
Скор балл для параметра «Средний чек на покупку с начала сессии»
USER_ROLE
Роль пользователя приложения/устройства
SCORE_USER_ADDED_DAYS_AGO
Скор балл для параметра «Давность добавления пользователя»
SCORE_USER_AUTHORIZATIONS_TODAY
Скор балл для параметра «Кол-во авторизаций пользователя за текущий день»
SCORE_CALL_IN_SESSION_FLAG
Скор балл для параметра «Признак звонка в сессии»
Значения каналов транзакции:
«0» – печатное (стикер со штриховым кодом поставщика товара, работы или услуги)
«0» – в месторасположении поставщика товара, работы или услуги/зарегистрированного адреса
«0» – необходимо присутствие поставщика товара, работы или услуги
«1» – печатное (квитанция, счет на оплату)
«1» – не в месторасположении поставщика товара, работы или услуги/зарегистрированного адреса
«1» – отсутствие поставщика товара, работы или услуги
«2» – печатное (журнал)
«2» – электронная коммерция
«2» – кассы самообслуживания
«3» – печатное (другое)
«3» – другое
«3» – другое
«4» – электронное (пункт продажи)
-
-
«5» - электронное (вебсайт)
-
-
«6» - электронное (приложение)
-
-
«7» - электронное (другое);
-
-
Last updated