For the complete documentation index, see llms.txt. This page is also available as Markdown.

Сообщение admi.010 (для целевой модели C2B2_V2)

Сообщение admi.010 должно соответствовать XSD схеме сообщения admi.010.001.02 стандарта ISO20022 и правилам заполнения документа, указанным в таблице ниже. Если поле не отмечено как опциональное, то оно является обязательным.

Ниже приведено описания для целевой модели (C2B2_V2).

В рамках целевой модели для передачи дополнительных данных о мерчанте расширен состав сведений в теге StatcDataRpt-> SplmtryData. Если поле не отмечено как опциональное, то оно является обязательным.

Нижеперечисленные параметры добавляются в рамках расширения состава данных:

Скор. балл определяется согласно документу «Параметры Единый QR (n)_V3.xlsx».

Наименование
Описание
Опциональность
Примечание

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 найдены успешно. Может принимать значения:

- 004 (оплата по QR-коду, используется для операций типа C2B2_V2 в рамках целевой модели);

- 005 (возврат по проведенной оплате, используется для операций типа C2BR_V2 в рамках целевой модели)

Параметр уже имеется в текущей структуре

QR_TYPE

Тип QR кода, обязательный в случае успешного ответа при QR_DATA_TYPE=004. Принимает значения:

- STATIC - для статического QR-кода

- DYNAMIC - для динамического QR-кода

Параметр уже имеется в текущей структуре

POS_ID

Идентификатор торговой точки в системе банка-эквайера. Используется для идентификации торговой точки, к которой относится платеж, максимальная длина: 35 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=004.

Параметр уже имеется в текущей структуре

BIC

БИК банка поставщика товара, работы или услуги (бенефициара), 8 символов (латинский алфавит и цифры), обязательный в случае успешного ответа при QR_DATA_TYPE=004.

Параметр уже имеется в текущей структуре

ACCOUNT_NUMBER

IBAN счета поставщика товара, работы или услуги (бенефициара), обязательный в случае успешного ответа при QR_DATA_TYPE=004. Шаблон:^[0-9A-Z]{20}$

Параметр уже имеется в текущей структуре

MCC

4-значный код категории продавца, обязательный в случае успешного ответа при QR_DATA_TYPE=004.

Параметр уже имеется в текущей структуре

COMPANY_NAME

Наименование поставщика товара, работы или услуги, максимальная длина: 350 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=004

Параметр уже имеется в текущей структуре

COUNTRY_OF_RESIDENCE

Код страны резидентства поставщика товара, работы или услуги, обязательный в случае успешного ответа при QR_DATA_TYPE=004. Значение в соответствии с ISO 3166-1 alpha 2, для Казахстана - «KZ».

Параметр уже имеется в текущей структуре

CITY

Город физического местонахождения поставщика товара, работы или услуги, максимальная длина: 35 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=004

Параметр уже имеется в текущей структуре

CURRENCY

Код валюты (буквенный), принимает значение KZT, обязательный в случае успешного ответа при QR_DATA_TYPE=004.

Параметр уже имеется в текущей структуре

AMOUNT

Сумма платежа, обязательный в случае успешного ответа при QR_DATA_TYPE=004 для динамических QR-кодов, не используется для статических QR-кодов, не должно превышать 100 000 000 000 00, должна передаваться в тиын (см. Правило передачи значений денежных сумм).

Параметр уже имеется в текущей структуре

KNP

Код назначения платежа, 3 символа (цифры), обязательный в случае успешного ответа при QR_DATA_TYPE=004.

Параметр уже имеется в текущей структуре

KNP_MESSAGE

Описание КНП, обязательный в случае успешного ответа при QR_DATA_TYPE=004. Длина: до 140 символов.

Параметр уже имеется в текущей структуре

BENEFICIARY_CODE

Код бенефициара, обязательный в случае успешного ответа при QR_DATA_TYPE=004. Значение этого поля состоит из двух цифр: первая цифра указывает признак резидентства (1 или 2), вторая сектор экономики (принимает значение от 1 до 9).

Параметр уже имеется в текущей структуре

SME

Признак того, что поставщика товара, работы или услуги является представителем малого или среднего бизнеса, обязательный в случае успешного ответа при QR_DATA_TYPE=004. Принимает значения: значение: 0 – не является МСБ, 1 – является МСБ.

Параметр уже имеется в текущей структуре

MERCHANT_CHANNEL

Канал транзакции. Трехзначная цифра. Значения каналов транзакции приведены в таблице ниже.

Опционально

Параметр уже имеется в текущей структуре

QR_ID

Идентификатор QR-кода, должен соответствовать значению, указанному в admi.009 с ключом QR_ID, шаблон: [0-9A-Za-z_=-]{8,50}.

Параметр уже имеется в текущей структуре

COMPANY_ID

ИИН/БИН поставщика товара, работы или услуги, , обязательный в случае успешного ответа при QR_DATA_TYPE=004.

Параметр уже имеется в текущей структуре

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

Скор балл для параметра «Признак звонка в сессии»

Last updated