Служба транзакций EMV (ARQC/ARPC) (CSNBEAC и CSNEEAC)

Tomcat · Jun 21, 2024

Служба транзакций EMV (ARQC/ARPC) упрощает обработку транзакций криптограммы запроса авторизации EMV (ARQC) и криптограммы ответа на авторизацию (ARPC). ARQC генерируется картой EMV по запросу терминала торговой точки для получения разрешения на оплату. ARQC передается через платежную сеть эмитенту для проверки. После того как эмитент проверил ARQC, эмитент генерирует ARPC (ответ). ARPC отправляется обратно через платежную сеть в торговый терминал для авторизации транзакции.

Служба транзакций EMV (ARQC/ARPC) выполняет следующие функции EMV:

Проверка криптограммы запроса авторизации (ARQC).
Генерация криптограммы ответа на авторизацию (ARPC).
Как проверка ARQC, так и создание ARPC.

Данную услугу можно использовать в следующих конкретных брендовых режимах:

Виза
МастерКард
EMV

Имя вызываемой службы для вызова AMODE(64) — CSNEEAC.

Родительская тема:
Финансовые услуги

Формат

Code:

CALL CSNBEAC(
 return_code,
 reason_code,
 exit_data_length,
 exit_data,
 rule_array_count,
 rule_array,
 issuer_master_key_identifier_length,
 issuer_master_key_identifier,
 issuer_ARPC_master_key_identifier_length,
 issuer_ARPC_master_key_identifier,
 pan_length,
 pan,
 pan_seq_number,
 cryptogram_info_length,
 cryptogram_info,
 atc,
 arc,
 arqc,
 arpc,
 unpredictable_number,
 reserved1_length,
 reserved1,
 reserved2_length,
 reserved2)

Параметры

код возврата

Направление	Тип
Выход	Целое число

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

код причины

Направление	Тип
Выход	Целое число

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

exit_data_length

Направление	Тип
Ввод, вывод	Целое число

Длина данных, передаваемых на выход установки. Данные идентифицируются в параметре exit_data .

выходные_данные

Направление	Тип
Ввод, вывод	Нить

Данные, которые передаются на выход установки.

rule_array_count

Направление	Тип
Вход	Целое число

Количество ключевых слов, которые вы указали в параметре rule_array . Минимальное значение — 3, максимальное — 4.
rule_array

Направление	Тип
Вход	Нить

Ключевые слова, которые предоставляют управляющую информацию вызываемой службе. Ключевые слова должны находиться в непрерывном хранилище, при этом каждое из ключевых слов должно быть выровнено по левому краю в своем собственном 8-байтовом месте и дополнено справа пробелами.

Таблица 1. Ключевые слова массива правил для службы транзакций EMV (ARQC/ARPC)

Ключевое слово	Значение
Алгоритм (обязательно)
TDES	Указывает использование Triple-DES.
Действие (требуется одно)
VERARQC	Указывает необходимость проверки входной криптограммы запроса авторизации.
GENARPC	Указывает на создание криптограммы ответа на авторизацию на основе входной криптограммы запроса на авторизацию и кода ответа на авторизацию (ARC).
VERGEN	Указывает как проверку криптограммы запроса авторизации, так и создание криптограммы ответа на авторизацию.
Режим ключа (требуется один) . Определяет механизм получения ключей.
ВИЗА	Указывает на использование деривации ключа Visa Cryptogram версии 10. В качестве сеансового ключа используется мастер-ключ карты для криптограмм приложений (ключи одинаковы для каждой сессии). См. спецификацию Visa, Приложение D2. Заполнение осуществляется двоичными нулями до тех пор, пока длина не станет кратной 8 байтам.
МК	Указывает на использование деривации ключа MasterCard M/CHIP 2.1. ATC и непредсказуемый номер зашифрованы 3DES с помощью главного ключа карты. Главный ключ карты используется при создании ARPC. Применяются правила заполнения EMV.
EMV	Указывает на использование получения сеансового ключа, как описано в Спецификации карт с интегральными схемами EMV для платежных систем версии 4.2 (EMV4.2), Книга 2, Приложение A1.3. Используйте этот режим ключа для Visa Cryptogram версии 14 и MasterCard M/CHIP 4. Применяются правила заполнения EMV.
Флаг управления (необязательно)
APPANSEQ	Указывает добавление порядкового номера PAN при получении главного ключа для конкретной карты. См. описания pan и pan_seq_number . По умолчанию порядковый номер PAN не добавляется.
Коэффициент перехода (один необязательный, действителен только в ключевом режиме EMV) . Коэффициент ветвления должен использоваться при получении сеансового ключа EMV.
TDESEMV2	Задает коэффициент ветвления 2 для высоты 16. Это значение по умолчанию.
TDESEMV4	Задает коэффициент ветвления 4 для высоты 8.

Issuer_master_key_identifier_length

Направление	Тип
Вход	Целое число

Указывает длину параметра Issuer_master_key_identifier в байтах. Значение должно быть 64.

Issuer_master_key_identifier

Направление	Тип
Ввод, вывод	String

64-байтовый идентификатор ключа DES (внутренний токен или метка ключа) для главного ключа эмитента для прикладных криптограмм (AC). Главный ключ эмитента — это ключ DES, из которого получаются ключи, специфичные для карты, а из ключей, специфичных для карты, извлекаются сеансовые ключи для криптограмм приложений.
При использовании режима ключа VISA или EMV этот ключ используется как для проверки ARQC (VERARQC и VERGEN), так и для генерации ARPC (GENARPC и VERGEN).
При использовании режима ключа MC этот ключ используется только для проверки ARQC (VERARQC и VERGEN). Issuer_ARPC_master_key_identifier должен содержать ключ генерации ARPC (GENARPC и VERGEN) .
Если предоставленный токен был зашифрован старым главным ключом, токен возвращается зашифрованным текущим главным ключом.

Таблица 2. Сервис транзакций EMV (ARQC/ARPC): основные требования

Ключевое слово режима ключа	Тип ключа	Подтип	Ключевые атрибуты использования
ВИЗА	DKYGENKY	DKYL0	Необходимо указать, какой ключ MAC будет получен (ключевое слово DMAC).
МК	DKYGENKY	DKYL1	Необходимо указать, какой ключ MAC будет получен (ключевое слово DMAC).
EMV	DKYGENKY	DKYL0	Необходимо указать, какой ключ MAC будет получен (ключевое слово DMAC).

Примечание. Для MasterCard M/Chip 2.1 вам потребуется главный ключ эмитента в двух версиях: по одному каждого подтипа (DKYL1 и DKYL0). Если указано действие VERARQC или VERGEN, этот ключ должен быть подтипом DKYL1 и использоваться для получения сеансового ключа для проверки ARQC. Ключ, который будет использоваться для генерации ARPC (GENARPC и VERGEN), должен быть указан во входном параметре Issuer_ARPC_master_key_identifier .

Issuer_ARPC_master_key_identifier_length

Направление	Тип
Вход	Целое число

Этот параметр определяет длину параметра Issuer_ARPC_master_key_identifier в байтах. Если указано ключевое слово режима MC, значение должно быть 64. В противном случае значение должно быть равно нулю.

Issuer_ARPC_master_key_identifier

Направление	Тип
Ввод, вывод	String

64-байтовый идентификатор ключа CCA DES (либо внутренний токен, либо метка ключа) для главного ключа эмитента для криптограмм ответа приложения (ARPC) при использовании режима ключа MC. Главный ключ ARPC эмитента — это ключ DES, из которого получается сеансовый ключ для генерации ARPC.
Используется только в том случае, если действие — GENARPC или VERGEN, а режим ключа — MC, где этот ключ является главным ключом эмитента, который будет использоваться для получения ключа, который будет использоваться для генерации ARPC.
Если предоставленный токен был зашифрован старым главным ключом, токен возвращается зашифрованным текущим главным ключом.
Требования к типу ключа: тип ключа должен быть DKYGENKY, подтип должен быть DKYL0, а использование ключа должно указывать, что будет получен ключ MAC (ключевое слово DMAC).
Примечание. Для MasterCard M/Chip 2.1 вам потребуется главный ключ эмитента в двух версиях: по одному каждого подтипа (DKYL1 и DKYL0). Если указано действие GENARPC или VERGEN, этот ключ должен быть подтипом DKYL0 и использоваться для получения сеансового ключа для генерации ARPC. Ключ, который будет использоваться для проверки ARQC (VERARQC и VERGEN), должен быть указан во входном параметре Issuer_master_key_identifier.

длина панорамы

Направление	Тип
Вход	Целое число

Длина параметра панорамирования в байтах . Значение должно быть 10.
кастрюля

Направление	Тип
Вход	String

Основной номер счета карты EMV длиной 10 байт. Данные должны быть в сжатом числовом формате и выровнены по правому краю в 10-байтовом поле, дополненном слева нулями. Например, PAN 1234567890 должен быть указан как x'00000000001234567890'.
Эти данные используются в сочетании с порядковым номером PAN для получения главного ключа карты. Точный набор правил описан в Спецификации карт с интегральной микросхемой EMV для платежных систем версии 4.2 (EMV4.2), Книга 2, Приложение A1.4.

pan_seq_number

Направление	Тип
Вход	String

1-байтовый порядковый номер основного номера счета карты EMV. Если было указано ключевое слово массива правил флага управления APPANSEQ, этот порядковый номер PAN используется в сочетании с PAN для получения главного ключа карты. Точный набор правил описан в Спецификации карт с интегральной микросхемой EMV для платежных систем версии 4.2 (EMV4.2), Книга 2, Приложение A1.4.

cryptogram_info_length

Направление	Тип
Вход	Целое число

Длина информации о криптограмме, указанной в параметре cryptogram_info . Это значение должно находиться в диапазоне от 1 до 252 включительно.

cryptogram_info

Направление	Тип
Вход	String

Информация криптограммы, на основе которой генерируется ARQC. Данные не должны быть дополнены.
Информация криптограммы дополняется следующим образом:

Механизм получения ключей	Заполнение
ВИЗА	Спецификация карты Visa ICC V1.4.0, Приложение D2 и D3
МК, EMV	EMV, Книга 2, Приложение А1.2

atc

Направление	Тип
Вход	String

2-байтовый счетчик транзакций приложения, используемый для создания ключа сеанса. Дополнительные сведения о создании сеансового ключа см. в правилах режима ключей.
Этот параметр должен иметь длину 2 байта.
Примечание. Первый байт — это старший байт, а второй — младший.

дуга

Направление	Тип
Вход	String

2-байтовый код ответа авторизации, который необходимо использовать для создания ARPC. Используется только в том случае, если указано действие GENARPC или VERGEN.
Этот параметр должен иметь длину 2 байта.
Примечание. Первый байт — это старший байт, а второй — младший.

arqc

Направление	Тип
Вход	String

Криптограмма запроса авторизации длиной 8 байт, полученная с платежной карты.
Этот параметр должен иметь длину 8 байт.

arqc

Направление	Тип
Выход	String

Криптограмма авторизационного ответа длиной 8 байт, которая будет отправлена обратно на платежную карту. ARPC получается путем шифрования ARQC XOR с помощью ARC (см. также EMV, Книга 2, 8.2).
Этот параметр должен иметь длину 8 байт.

непредсказуемый_номер

Направление	Тип
Вход	Нить

4-байтовое непредсказуемое число, используемое в схеме создания сеансового ключа MasterCard M/Chip 2.1.
Данные в этом поле не будут переформатированы API перед использованием.
Этот параметр должен иметь длину 4 байта.

зарезервировано1_длина

Направление	Тип
Вход	Целое число

Длина в байтах параметра Reserved1. Значение должно быть 0.

зарезервировано1

Направление	Тип
Вход	String

Это поле игнорируется.

зарезервировано2_длина

Направление	Тип
Вход	Целое число

Длина параметра Reserved2 в байтах. Значение должно быть 0.
зарезервировано2

Направление	Тип
Вход	String

Это поле игнорируется.

Примечания по использованию

SAF может быть вызван для проверки того, что вызывающая сторона имеет право использовать эту вызываемую службу, метку ключа или внутренние токены защищенного ключа, которые хранятся в CKDS.

Криптографические службы, используемые службой транзакций EMV (ARQC/ARPC)

Служба транзакций EMV (ARQC/ARPC) использует следующие криптографические службы CCA:

CSNBKTB — сборка токена ключа
CSNBDKG — Генерация диверсифицированного ключа
CSNBMGN – создание MAC-адреса
CSNBMVR – проверка MAC

Вызывающему абоненту не требуется авторизация для каждой из этих служб, а только для службы транзакций EMV (ARQC/ARPC). Кроме того, у вызывающего абонента должны быть включены необходимые точки управления доступом.

Точки контроля доступа

Для использования службы транзакций EMV (ARQC/ARPC) необходимо включить следующие точки управления доступом:

Генерация диверсифицированного ключа — TDES-ENC
Генерация диверсифицированного ключа — SESS-XOR
Создание диверсифицированного ключа — TDESEMV2/TDESEMV4
Создание MAC-адреса
MAC-проверка

Требуемое оборудование

В этой таблице перечислено необходимое криптографическое оборудование для каждого типа сервера и описаны ограничения для этой вызываемой службы.

Таблица 3. Транзакции EMV (ARQC/ARPC) Требуется оборудование для обслуживания

Сервер	Необходимое криптографическое оборудование	Ограничения
IBM System z9 EC IBM System z9 BC	Сопроцессор Crypto Express2
IBM System z10 EC IBM System z10 BC	Сопроцессор Crypto Express2 Сопроцессор Crypto Express3
IBM zEnterprise 196 IBM zEnterprise 114	Сопроцессор Crypto Express3
IBM zEnterprise EC12 IBM zEnterprise BC12	Сопроцессор Crypto Express3 Сопроцессор Crypto Express4 CCA
IBM z13 IBM z13s	Сопроцессор Crypto Express5 CCA

(c) https://www.ibm.com/docs/en/zos/2.3...-transaction-arqcarpc-service-csnbeac-csneeac

Служба транзакций EMV (ARQC/ARPC) (CSNBEAC и CSNEEAC)

Tomcat

Professional

Формат

Параметры

Примечания по использованию

Криптографические службы, используемые службой транзакций EMV (ARQC/ARPC)

Точки контроля доступа

Требуемое оборудование

Similar threads

Служба транзакций EMV (ARQC/ARPC) (CSNBEAC и CSNEEAC)

Tomcat

Professional

Формат​

Параметры​

Примечания по использованию​

Криптографические службы, используемые службой транзакций EMV (ARQC/ARPC)​

Точки контроля доступа​

Требуемое оборудование​

Similar threads

Формат

Параметры

Примечания по использованию

Криптографические службы, используемые службой транзакций EMV (ARQC/ARPC)

Точки контроля доступа

Требуемое оборудование