PaymentCryptographyDataPlaneClient

Index > PaymentCryptographyDataPlane > PaymentCryptographyDataPlaneClient

Auto-generated documentation for PaymentCryptographyDataPlane type annotations stubs module mypy-boto3-payment-cryptography-data.

PaymentCryptographyDataPlaneClient

Type annotations and code completion for boto3.client("payment-cryptography-data"). boto3 documentation

# PaymentCryptographyDataPlaneClient usage example

from boto3.session import Session
from mypy_boto3_payment_cryptography_data.client import PaymentCryptographyDataPlaneClient

def get_payment-cryptography-data_client() -> PaymentCryptographyDataPlaneClient:
    return Session().client("payment-cryptography-data")

Exceptions

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("payment-cryptography-data").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("payment-cryptography-data")

try:
    do_something(client)
except (
    client.exceptions.AccessDeniedException,
    client.exceptions.ClientError,
    client.exceptions.InternalServerException,
    client.exceptions.ResourceNotFoundException,
    client.exceptions.ThrottlingException,
    client.exceptions.ValidationException,
    client.exceptions.VerificationFailedException,
) as e:
    print(e)

# Exceptions.exceptions type checking example

from mypy_boto3_payment_cryptography_data.client import Exceptions

def handle_error(exc: Exceptions.AccessDeniedException) -> None:
    ...

Methods

can_paginate

Check if an operation can be paginated.

Type annotations and code completion for boto3.client("payment-cryptography-data").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

close

Closes underlying endpoint connections.

Type annotations and code completion for boto3.client("payment-cryptography-data").close method. boto3 documentation

# close method definition

def close(
    self,
) -> None:
    ...

decrypt_data

Decrypts ciphertext data to plaintext using a symmetric (TDES, AES), asymmetric (RSA), or derived (DUKPT or EMV) encryption key scheme.

Type annotations and code completion for boto3.client("payment-cryptography-data").decrypt_data method. boto3 documentation

# decrypt_data method definition

def decrypt_data(
    self,
    *,
    KeyIdentifier: str,
    CipherText: str,
    DecryptionAttributes: EncryptionDecryptionAttributesTypeDef,  # (1)
    WrappedKey: WrappedKeyTypeDef = ...,  # (2)
) -> DecryptDataOutputTypeDef:  # (3)
    ...

1. See EncryptionDecryptionAttributesTypeDef
2. See WrappedKeyTypeDef
3. See DecryptDataOutputTypeDef

# decrypt_data method usage example with argument unpacking

kwargs: DecryptDataInputRequestTypeDef = {  # (1)
    "KeyIdentifier": ...,
    "CipherText": ...,
    "DecryptionAttributes": ...,
}

parent.decrypt_data(**kwargs)

1. See DecryptDataInputRequestTypeDef

encrypt_data

Encrypts plaintext data to ciphertext using a symmetric (TDES, AES), asymmetric (RSA), or derived (DUKPT or EMV) encryption key scheme.

Type annotations and code completion for boto3.client("payment-cryptography-data").encrypt_data method. boto3 documentation

# encrypt_data method definition

def encrypt_data(
    self,
    *,
    KeyIdentifier: str,
    PlainText: str,
    EncryptionAttributes: EncryptionDecryptionAttributesTypeDef,  # (1)
    WrappedKey: WrappedKeyTypeDef = ...,  # (2)
) -> EncryptDataOutputTypeDef:  # (3)
    ...

1. See EncryptionDecryptionAttributesTypeDef
2. See WrappedKeyTypeDef
3. See EncryptDataOutputTypeDef

# encrypt_data method usage example with argument unpacking

kwargs: EncryptDataInputRequestTypeDef = {  # (1)
    "KeyIdentifier": ...,
    "PlainText": ...,
    "EncryptionAttributes": ...,
}

parent.encrypt_data(**kwargs)

1. See EncryptDataInputRequestTypeDef

generate_card_validation_data

Generates card-related validation data using algorithms such as Card Verification Values (CVV/CVV2), Dynamic Card Verification Values (dCVV/dCVV2), or Card Security Codes (CSC).

Type annotations and code completion for boto3.client("payment-cryptography-data").generate_card_validation_data method. boto3 documentation

# generate_card_validation_data method definition

def generate_card_validation_data(
    self,
    *,
    KeyIdentifier: str,
    PrimaryAccountNumber: str,
    GenerationAttributes: CardGenerationAttributesTypeDef,  # (1)
    ValidationDataLength: int = ...,
) -> GenerateCardValidationDataOutputTypeDef:  # (2)
    ...

1. See CardGenerationAttributesTypeDef
2. See GenerateCardValidationDataOutputTypeDef

# generate_card_validation_data method usage example with argument unpacking

kwargs: GenerateCardValidationDataInputRequestTypeDef = {  # (1)
    "KeyIdentifier": ...,
    "PrimaryAccountNumber": ...,
    "GenerationAttributes": ...,
}

parent.generate_card_validation_data(**kwargs)

1. See GenerateCardValidationDataInputRequestTypeDef

generate_mac

Generates a Message Authentication Code (MAC) cryptogram within Amazon Web Services Payment Cryptography.

Type annotations and code completion for boto3.client("payment-cryptography-data").generate_mac method. boto3 documentation

# generate_mac method definition

def generate_mac(
    self,
    *,
    KeyIdentifier: str,
    MessageData: str,
    GenerationAttributes: MacAttributesTypeDef,  # (1)
    MacLength: int = ...,
) -> GenerateMacOutputTypeDef:  # (2)
    ...

1. See MacAttributesTypeDef
2. See GenerateMacOutputTypeDef

# generate_mac method usage example with argument unpacking

kwargs: GenerateMacInputRequestTypeDef = {  # (1)
    "KeyIdentifier": ...,
    "MessageData": ...,
    "GenerationAttributes": ...,
}

parent.generate_mac(**kwargs)

1. See GenerateMacInputRequestTypeDef

generate_mac_emv_pin_change

Generates an issuer script mac for EMV payment cards that use offline PINs as the cardholder verification method (CVM).

Type annotations and code completion for boto3.client("payment-cryptography-data").generate_mac_emv_pin_change method. boto3 documentation

# generate_mac_emv_pin_change method definition

def generate_mac_emv_pin_change(
    self,
    *,
    NewPinPekIdentifier: str,
    NewEncryptedPinBlock: str,
    PinBlockFormat: PinBlockFormatForEmvPinChangeType,  # (1)
    SecureMessagingIntegrityKeyIdentifier: str,
    SecureMessagingConfidentialityKeyIdentifier: str,
    MessageData: str,
    DerivationMethodAttributes: DerivationMethodAttributesTypeDef,  # (2)
) -> GenerateMacEmvPinChangeOutputTypeDef:  # (3)
    ...

1. See PinBlockFormatForEmvPinChangeType
2. See DerivationMethodAttributesTypeDef
3. See GenerateMacEmvPinChangeOutputTypeDef

# generate_mac_emv_pin_change method usage example with argument unpacking

kwargs: GenerateMacEmvPinChangeInputRequestTypeDef = {  # (1)
    "NewPinPekIdentifier": ...,
    "NewEncryptedPinBlock": ...,
    "PinBlockFormat": ...,
    "SecureMessagingIntegrityKeyIdentifier": ...,
    "SecureMessagingConfidentialityKeyIdentifier": ...,
    "MessageData": ...,
    "DerivationMethodAttributes": ...,
}

parent.generate_mac_emv_pin_change(**kwargs)

1. See GenerateMacEmvPinChangeInputRequestTypeDef

generate_pin_data

Generates pin-related data such as PIN, PIN Verification Value (PVV), PIN Block, and PIN Offset during new card issuance or reissuance.

Type annotations and code completion for boto3.client("payment-cryptography-data").generate_pin_data method. boto3 documentation

# generate_pin_data method definition

def generate_pin_data(
    self,
    *,
    GenerationKeyIdentifier: str,
    EncryptionKeyIdentifier: str,
    GenerationAttributes: PinGenerationAttributesTypeDef,  # (1)
    PrimaryAccountNumber: str,
    PinBlockFormat: PinBlockFormatForPinDataType,  # (2)
    PinDataLength: int = ...,
    EncryptionWrappedKey: WrappedKeyTypeDef = ...,  # (3)
) -> GeneratePinDataOutputTypeDef:  # (4)
    ...

1. See PinGenerationAttributesTypeDef
2. See PinBlockFormatForPinDataType
3. See WrappedKeyTypeDef
4. See GeneratePinDataOutputTypeDef

# generate_pin_data method usage example with argument unpacking

kwargs: GeneratePinDataInputRequestTypeDef = {  # (1)
    "GenerationKeyIdentifier": ...,
    "EncryptionKeyIdentifier": ...,
    "GenerationAttributes": ...,
    "PrimaryAccountNumber": ...,
    "PinBlockFormat": ...,
}

parent.generate_pin_data(**kwargs)

1. See GeneratePinDataInputRequestTypeDef

generate_presigned_url

Generate a presigned url given a client, its method, and arguments.

Type annotations and code completion for boto3.client("payment-cryptography-data").generate_presigned_url method. boto3 documentation

# generate_presigned_url method definition

def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

re_encrypt_data

Re-encrypt ciphertext using DUKPT or Symmetric data encryption keys.

Type annotations and code completion for boto3.client("payment-cryptography-data").re_encrypt_data method. boto3 documentation

# re_encrypt_data method definition

def re_encrypt_data(
    self,
    *,
    IncomingKeyIdentifier: str,
    OutgoingKeyIdentifier: str,
    CipherText: str,
    IncomingEncryptionAttributes: ReEncryptionAttributesTypeDef,  # (1)
    OutgoingEncryptionAttributes: ReEncryptionAttributesTypeDef,  # (1)
    IncomingWrappedKey: WrappedKeyTypeDef = ...,  # (3)
    OutgoingWrappedKey: WrappedKeyTypeDef = ...,  # (3)
) -> ReEncryptDataOutputTypeDef:  # (5)
    ...

1. See ReEncryptionAttributesTypeDef
2. See ReEncryptionAttributesTypeDef
3. See WrappedKeyTypeDef
4. See WrappedKeyTypeDef
5. See ReEncryptDataOutputTypeDef

# re_encrypt_data method usage example with argument unpacking

kwargs: ReEncryptDataInputRequestTypeDef = {  # (1)
    "IncomingKeyIdentifier": ...,
    "OutgoingKeyIdentifier": ...,
    "CipherText": ...,
    "IncomingEncryptionAttributes": ...,
    "OutgoingEncryptionAttributes": ...,
}

parent.re_encrypt_data(**kwargs)

1. See ReEncryptDataInputRequestTypeDef

translate_pin_data

Translates encrypted PIN block from and to ISO 9564 formats 0,1,3,4.

Type annotations and code completion for boto3.client("payment-cryptography-data").translate_pin_data method. boto3 documentation

# translate_pin_data method definition

def translate_pin_data(
    self,
    *,
    IncomingKeyIdentifier: str,
    OutgoingKeyIdentifier: str,
    IncomingTranslationAttributes: TranslationIsoFormatsTypeDef,  # (1)
    OutgoingTranslationAttributes: TranslationIsoFormatsTypeDef,  # (1)
    EncryptedPinBlock: str,
    IncomingDukptAttributes: DukptDerivationAttributesTypeDef = ...,  # (3)
    OutgoingDukptAttributes: DukptDerivationAttributesTypeDef = ...,  # (3)
    IncomingWrappedKey: WrappedKeyTypeDef = ...,  # (5)
    OutgoingWrappedKey: WrappedKeyTypeDef = ...,  # (5)
) -> TranslatePinDataOutputTypeDef:  # (7)
    ...

1. See TranslationIsoFormatsTypeDef
2. See TranslationIsoFormatsTypeDef
3. See DukptDerivationAttributesTypeDef
4. See DukptDerivationAttributesTypeDef
5. See WrappedKeyTypeDef
6. See WrappedKeyTypeDef
7. See TranslatePinDataOutputTypeDef

# translate_pin_data method usage example with argument unpacking

kwargs: TranslatePinDataInputRequestTypeDef = {  # (1)
    "IncomingKeyIdentifier": ...,
    "OutgoingKeyIdentifier": ...,
    "IncomingTranslationAttributes": ...,
    "OutgoingTranslationAttributes": ...,
    "EncryptedPinBlock": ...,
}

parent.translate_pin_data(**kwargs)

1. See TranslatePinDataInputRequestTypeDef

verify_auth_request_cryptogram

Verifies Authorization Request Cryptogram (ARQC) for a EMV chip payment card authorization.

Type annotations and code completion for boto3.client("payment-cryptography-data").verify_auth_request_cryptogram method. boto3 documentation

# verify_auth_request_cryptogram method definition

def verify_auth_request_cryptogram(
    self,
    *,
    KeyIdentifier: str,
    TransactionData: str,
    AuthRequestCryptogram: str,
    MajorKeyDerivationMode: MajorKeyDerivationModeType,  # (1)
    SessionKeyDerivationAttributes: SessionKeyDerivationTypeDef,  # (2)
    AuthResponseAttributes: CryptogramAuthResponseTypeDef = ...,  # (3)
) -> VerifyAuthRequestCryptogramOutputTypeDef:  # (4)
    ...

1. See MajorKeyDerivationModeType
2. See SessionKeyDerivationTypeDef
3. See CryptogramAuthResponseTypeDef
4. See VerifyAuthRequestCryptogramOutputTypeDef

# verify_auth_request_cryptogram method usage example with argument unpacking

kwargs: VerifyAuthRequestCryptogramInputRequestTypeDef = {  # (1)
    "KeyIdentifier": ...,
    "TransactionData": ...,
    "AuthRequestCryptogram": ...,
    "MajorKeyDerivationMode": ...,
    "SessionKeyDerivationAttributes": ...,
}

parent.verify_auth_request_cryptogram(**kwargs)

1. See VerifyAuthRequestCryptogramInputRequestTypeDef

verify_card_validation_data

Verifies card-related validation data using algorithms such as Card Verification Values (CVV/CVV2), Dynamic Card Verification Values (dCVV/dCVV2) and Card Security Codes (CSC).

Type annotations and code completion for boto3.client("payment-cryptography-data").verify_card_validation_data method. boto3 documentation

# verify_card_validation_data method definition

def verify_card_validation_data(
    self,
    *,
    KeyIdentifier: str,
    PrimaryAccountNumber: str,
    VerificationAttributes: CardVerificationAttributesTypeDef,  # (1)
    ValidationData: str,
) -> VerifyCardValidationDataOutputTypeDef:  # (2)
    ...

1. See CardVerificationAttributesTypeDef
2. See VerifyCardValidationDataOutputTypeDef

# verify_card_validation_data method usage example with argument unpacking

kwargs: VerifyCardValidationDataInputRequestTypeDef = {  # (1)
    "KeyIdentifier": ...,
    "PrimaryAccountNumber": ...,
    "VerificationAttributes": ...,
    "ValidationData": ...,
}

parent.verify_card_validation_data(**kwargs)

1. See VerifyCardValidationDataInputRequestTypeDef

verify_mac

Verifies a Message Authentication Code (MAC).

Type annotations and code completion for boto3.client("payment-cryptography-data").verify_mac method. boto3 documentation

# verify_mac method definition

def verify_mac(
    self,
    *,
    KeyIdentifier: str,
    MessageData: str,
    Mac: str,
    VerificationAttributes: MacAttributesTypeDef,  # (1)
    MacLength: int = ...,
) -> VerifyMacOutputTypeDef:  # (2)
    ...

1. See MacAttributesTypeDef
2. See VerifyMacOutputTypeDef

# verify_mac method usage example with argument unpacking

kwargs: VerifyMacInputRequestTypeDef = {  # (1)
    "KeyIdentifier": ...,
    "MessageData": ...,
    "Mac": ...,
    "VerificationAttributes": ...,
}

parent.verify_mac(**kwargs)

1. See VerifyMacInputRequestTypeDef

verify_pin_data

Verifies pin-related data such as PIN and PIN Offset using algorithms including VISA PVV and IBM3624.

Type annotations and code completion for boto3.client("payment-cryptography-data").verify_pin_data method. boto3 documentation

# verify_pin_data method definition

def verify_pin_data(
    self,
    *,
    VerificationKeyIdentifier: str,
    EncryptionKeyIdentifier: str,
    VerificationAttributes: PinVerificationAttributesTypeDef,  # (1)
    EncryptedPinBlock: str,
    PrimaryAccountNumber: str,
    PinBlockFormat: PinBlockFormatForPinDataType,  # (2)
    PinDataLength: int = ...,
    DukptAttributes: DukptAttributesTypeDef = ...,  # (3)
    EncryptionWrappedKey: WrappedKeyTypeDef = ...,  # (4)
) -> VerifyPinDataOutputTypeDef:  # (5)
    ...

1. See PinVerificationAttributesTypeDef
2. See PinBlockFormatForPinDataType
3. See DukptAttributesTypeDef
4. See WrappedKeyTypeDef
5. See VerifyPinDataOutputTypeDef

# verify_pin_data method usage example with argument unpacking

kwargs: VerifyPinDataInputRequestTypeDef = {  # (1)
    "VerificationKeyIdentifier": ...,
    "EncryptionKeyIdentifier": ...,
    "VerificationAttributes": ...,
    "EncryptedPinBlock": ...,
    "PrimaryAccountNumber": ...,
    "PinBlockFormat": ...,
}

parent.verify_pin_data(**kwargs)

1. See VerifyPinDataInputRequestTypeDef