Spec-Zone.ru › AWS CLI v2

[ aws . payment-cryptography-data ]

verify-card-validation-data

Описание

Проверяет данные валидации карты, используя алгоритмы, такие как значения проверки карты (CVV/CVV2), динамические значения проверки карты (dCVV/dCVV2) и коды безопасности карты (CSC). Дополнительную информацию см. в руководстве пользователя Amazon Web Services Payment Cryptography в разделе Проверка данных карты.

Данная операция проверяет коды CVV или CSC, напечатанные на платежной кредитной или дебетовой карте во время транзакции по оплате картой. Значения входных данных обычно предоставляются в рамках входящей транзакции поставщику услуг или партнеру по платформе. Amazon Web Services Payment Cryptography использует CVV или CSC, PAN (Основной номер счета) и срок действия карты для проверки её действительности во время обработки транзакции. В этой операции ключ шифрования CVK (ключ проверки карты) для использования с проверкой данных карты такой же, как и используемый для GenerateCardValidationData.

Дополнительную информацию о допустимых ключах для этой операции см. в руководстве пользователя Amazon Web Services Payment Cryptography в разделе Понимание атрибутов ключей и Типов ключей для определенных операций с данными.

Использование в разных учетных записях : Эта операция не может быть использована в разных учетных записях Amazon Web Services.

Связанные операции:

  • GenerateCardValidationData
  • VerifyAuthRequestCryptogram
  • VerifyPinData

См. также: Документация API AWS

Синопсис

  verify-card-validation-data
--key-identifier <value>
--primary-account-number <value>
--verification-attributes <value>
--validation-data <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--key-identifier (строка)

keyARN ключа шифрования CVK, который Amazon Web Services Payment Cryptography использует для проверки данных карты.

--primary-account-number (строка)

Основной номер счета (PAN), уникальный идентификатор платежной кредитной или дебетовой карты, который связывает карту с конкретным держателем счета.

--verification-attributes (структура помеченного объединения)

Алгоритм, используемый для проверки данных карты в Amazon Web Services Payment Cryptography.

Примечание

Это структура помеченного объединения. Может быть установлено только одно из следующих верхних ключей: AmexCardSecurityCodeVersion1, AmexCardSecurityCodeVersion2, CardVerificationValue1, CardVerificationValue2, CardHolderVerificationValue, DynamicCardVerificationCode, DynamicCardVerificationValue, DiscoverDynamicCardVerificationCode.

AmexCardSecurityCodeVersion1 -> (структура)

Параметры данных карты, необходимые для генерации кода безопасности карты (CSC2) для платежной карты AMEX.

CardExpiryDate -> (строка)

Срок действия платежной карты.

AmexCardSecurityCodeVersion2 -> (структура)

Параметры данных карты, необходимые для проверки кода безопасности карты (CSC2) для платежной карты AMEX.

CardExpiryDate -> (строка)

Срок действия платежной карты.

ServiceCode -> (строка)

Код услуги платежной карты AMEX. Он отличается от кода безопасности карты (CSC).

CardVerificationValue1 -> (структура)

Параметры данных карты, необходимые для проверки значения проверки карты (CVV) для платежной карты.

CardExpiryDate -> (строка)

Срок действия платежной карты.

ServiceCode -> (строка)

Код услуги платежной карты. Он отличается от кода безопасности карты (CSC).

CardVerificationValue2 -> (структура)

Параметры данных карты, необходимые для проверки значения проверки карты (CVV2) для платежной карты.

CardExpiryDate -> (строка)

Срок действия платежной карты.

CardHolderVerificationValue -> (структура)

Параметры данных карты, необходимые для проверки значения проверки держателя карты для платежной карты.

UnpredictableNumber -> (строка)

Случайное число, сгенерированное эмитентом.

PanSequenceNumber -> (строка)

Число, которое идентифицирует и различает платежные карты с одинаковым основным номером счета (PAN).

ApplicationTransactionCounter -> (строка)

Значение счётчика транзакций, полученное с POS-терминала.

DynamicCardVerificationCode -> (структура)

Параметры данных карты, необходимые для проверки кода динамической проверки карты (dCVC) для платежной карты.

UnpredictableNumber -> (строка)

Случайное число, сгенерированное эмитентом.

PanSequenceNumber -> (строка)

Число, которое идентифицирует и различает платежные карты с одинаковым основным номером счета (PAN).

ApplicationTransactionCounter -> (строка)

Значение счётчика транзакций, полученное с терминала.

TrackData -> (строка)

Данные на двух дорожках магнитных карт, используемых для финансовых транзакций. Включает имя держателя карты, PAN, срок действия, идентификатор банка (BIN) и ряд других чисел, которые банк-эмитент использует для проверки полученных данных.

DynamicCardVerificationValue -> (структура)

Параметры данных карты, необходимые для проверки значения динамической проверки карты (dCVV) для платежной карты.

PanSequenceNumber -> (строка)

Число, которое идентифицирует и различает платежные карты с одинаковым основным номером счета (PAN).

CardExpiryDate -> (строка)

Срок действия платежной карты.

ServiceCode -> (строка)

Код услуги платежной карты. Он отличается от кода безопасности карты (CSC).

ApplicationTransactionCounter -> (строка)

Значение счётчика транзакций, полученное с терминала.

DiscoverDynamicCardVerificationCode -> (структура)

Параметры данных карты, необходимые для проверки кода динамической проверки карты (dCVC) для платежной карты.

CardExpiryDate -> (строка)

Срок действия платежной карты.

UnpredictableNumber -> (строка)

Случайное число, сгенерированное эмитентом.

ApplicationTransactionCounter -> (строка)

Значение счётчика транзакций, полученное с терминала.

Сокращенная синтаксическая конструкция:

AmexCardSecurityCodeVersion1={CardExpiryDate=string},AmexCardSecurityCodeVersion2={CardExpiryDate=string,ServiceCode=string},CardVerificationValue1={CardExpiryDate=string,ServiceCode=string},CardVerificationValue2={CardExpiryDate=string},CardHolderVerificationValue={UnpredictableNumber=string,PanSequenceNumber=string,ApplicationTransactionCounter=string},DynamicCardVerificationCode={UnpredictableNumber=string,PanSequenceNumber=string,ApplicationTransactionCounter=string,TrackData=string},DynamicCardVerificationValue={PanSequenceNumber=string,CardExpiryDate=string,ServiceCode=string,ApplicationTransactionCounter=string},DiscoverDynamicCardVerificationCode={CardExpiryDate=string,UnpredictableNumber=string,ApplicationTransactionCounter=string}

Синтаксис JSON:

{
  "AmexCardSecurityCodeVersion1": {
    "CardExpiryDate": "string"
  },
  "AmexCardSecurityCodeVersion2": {
    "CardExpiryDate": "string",
    "ServiceCode": "string"
  },
  "CardVerificationValue1": {
    "CardExpiryDate": "string",
    "ServiceCode": "string"
  },
  "CardVerificationValue2": {
    "CardExpiryDate": "string"
  },
  "CardHolderVerificationValue": {
    "UnpredictableNumber": "string",
    "PanSequenceNumber": "string",
    "ApplicationTransactionCounter": "string"
  },
  "DynamicCardVerificationCode": {
    "UnpredictableNumber": "string",
    "PanSequenceNumber": "string",
    "ApplicationTransactionCounter": "string",
    "TrackData": "string"
  },
  "DynamicCardVerificationValue": {
    "PanSequenceNumber": "string",
    "CardExpiryDate": "string",
    "ServiceCode": "string",
    "ApplicationTransactionCounter": "string"
  },
  "DiscoverDynamicCardVerificationCode": {
    "CardExpiryDate": "string",
    "UnpredictableNumber": "string",
    "ApplicationTransactionCounter": "string"
  }
}

--validation-data (строка)

Значение CVV или CSC для проверки данных карты в Amazon Web Services Payment Cryptography.

--cli-input-json | --cli-input-yaml (строка) Чтение аргументов из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения будут переопределять значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который может быть использован в качестве аргумента для --cli-input-json. Аналогично, если предоставлено значение yaml-input, будет выведен пример входного YAML, который может быть использован с --cli-input-yaml. Если предоставлено значение output, проверяет входные данные команд и возвращает пример выходного JSON для данной команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию команды на указанный URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Использовать определенный регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию данного инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • включено
  • выключено
  • автоматически

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружаться, если этот аргумент указан.

--ca-bundle (строка)

Файл с набором сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию - 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию - 60 секунд.

--cli-binary-format (строка)

Стиль форматирования двоичных блоков. Формат по умолчанию - base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, у вас должен быть установлен и настроен AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, похожие на Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для проверки CVV

Следующий verify-card-validation-data пример проверяет CVV/CVV2 для PAN.

aws payment-cryptography-data verify-card-validation-data \
    --key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi \
    --primary-account-number=171234567890123 \
    --verification-attributes CardVerificationValue2={CardExpiryDate=0123} \
    --validation-data 801

Вывод:

{
    "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi",
    "KeyCheckValue": "CADDA1"
}

Для получения дополнительной информации см. Проверка данных карты в Руководстве пользователя AWS Payment Cryptography.

Вывод

KeyArn -> (строка)

Идентификатор keyARN ключа шифрования CVK, который Amazon Web Services Payment Cryptography использует для проверки CVV или CSC.

KeyCheckValue -> (строка)

Значение проверки ключа (KCV) ключа шифрования. KCV используется для проверки того, что все стороны, владеющие данным ключом, имеют один и тот же ключ, или для выявления изменений ключа.

Amazon Web Services Payment Cryptography вычисляет KCV в соответствии со спецификацией CMAC.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API