@aws-sdk/client-payment-cryptography-data 3.1050.0 → 3.1051.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -0
- package/dist-cjs/index.js +20 -0
- package/dist-cjs/schemas/schemas_0.js +22 -5
- package/dist-es/PaymentCryptographyData.js +2 -0
- package/dist-es/commands/GenerateAuthRequestCryptogramCommand.js +16 -0
- package/dist-es/commands/index.js +1 -0
- package/dist-es/models/enums.js +5 -0
- package/dist-es/schemas/schemas_0.js +19 -2
- package/dist-types/PaymentCryptographyData.d.ts +7 -0
- package/dist-types/PaymentCryptographyDataClient.d.ts +3 -2
- package/dist-types/commands/DecryptDataCommand.d.ts +1 -1
- package/dist-types/commands/EncryptDataCommand.d.ts +1 -1
- package/dist-types/commands/GenerateAs2805KekValidationCommand.d.ts +2 -1
- package/dist-types/commands/GenerateAuthRequestCryptogramCommand.d.ts +121 -0
- package/dist-types/commands/GenerateCardValidationDataCommand.d.ts +1 -1
- package/dist-types/commands/GenerateMacCommand.d.ts +1 -1
- package/dist-types/commands/GenerateMacEmvPinChangeCommand.d.ts +1 -1
- package/dist-types/commands/GeneratePinDataCommand.d.ts +1 -1
- package/dist-types/commands/ReEncryptDataCommand.d.ts +1 -1
- package/dist-types/commands/TranslateKeyMaterialCommand.d.ts +1 -1
- package/dist-types/commands/TranslatePinDataCommand.d.ts +1 -1
- package/dist-types/commands/VerifyAuthRequestCryptogramCommand.d.ts +1 -1
- package/dist-types/commands/VerifyCardValidationDataCommand.d.ts +1 -1
- package/dist-types/commands/VerifyMacCommand.d.ts +1 -1
- package/dist-types/commands/VerifyPinDataCommand.d.ts +1 -1
- package/dist-types/commands/index.d.ts +1 -0
- package/dist-types/models/enums.d.ts +13 -0
- package/dist-types/models/models_0.d.ts +246 -196
- package/dist-types/schemas/schemas_0.d.ts +3 -0
- package/dist-types/ts3.4/PaymentCryptographyData.d.ts +17 -0
- package/dist-types/ts3.4/PaymentCryptographyDataClient.d.ts +6 -0
- package/dist-types/ts3.4/commands/GenerateAuthRequestCryptogramCommand.d.ts +53 -0
- package/dist-types/ts3.4/commands/index.d.ts +1 -0
- package/dist-types/ts3.4/models/enums.d.ts +7 -0
- package/dist-types/ts3.4/models/models_0.d.ts +102 -89
- package/dist-types/ts3.4/schemas/schemas_0.d.ts +3 -0
- package/package.json +1 -1
|
@@ -29,7 +29,7 @@ declare const ReEncryptDataCommand_base: {
|
|
|
29
29
|
};
|
|
30
30
|
};
|
|
31
31
|
/**
|
|
32
|
-
* <p>Re-encrypt ciphertext using DUKPT or Symmetric data encryption keys. </p> <p>You can either generate an encryption key within Amazon Web Services Payment Cryptography by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html">CreateKey</a> or import your own encryption key by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ImportKey.html">ImportKey</a>. The <code>KeyArn</code> for use with this operation must be in a compatible key state with <code>KeyModesOfUse</code> set to <code>Encrypt</code>. </p> <p>This operation also supports dynamic keys, allowing you to pass a dynamic encryption key as a TR-31 WrappedKeyBlock. This can be used when key material is frequently rotated, such as during every card transaction, and there is need to avoid importing short-lived keys into Amazon Web Services Payment Cryptography. To re-encrypt using dynamic keys, the <code>keyARN</code> is the Key Encryption Key (KEK) of the TR-31 wrapped encryption key material. The incoming wrapped key shall have a key purpose of D0 with a mode of use of B or D. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/use-cases-acquirers-dynamickeys.html">Using Dynamic Keys</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>For symmetric and DUKPT encryption, Amazon Web Services Payment Cryptography supports <code>TDES</code> and <code>AES</code> algorithms. To encrypt using DUKPT, a DUKPT key must already exist within your account with <code>KeyModesOfUse</code> set to <code>DeriveKey</code> or a new DUKPT can be generated by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html">CreateKey</a>.</p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation
|
|
32
|
+
* <p>Re-encrypt ciphertext using DUKPT or Symmetric data encryption keys. </p> <p>You can either generate an encryption key within Amazon Web Services Payment Cryptography by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html">CreateKey</a> or import your own encryption key by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ImportKey.html">ImportKey</a>. The <code>KeyArn</code> for use with this operation must be in a compatible key state with <code>KeyModesOfUse</code> set to <code>Encrypt</code>. </p> <p>This operation also supports dynamic keys, allowing you to pass a dynamic encryption key as a TR-31 WrappedKeyBlock. This can be used when key material is frequently rotated, such as during every card transaction, and there is need to avoid importing short-lived keys into Amazon Web Services Payment Cryptography. To re-encrypt using dynamic keys, the <code>keyARN</code> is the Key Encryption Key (KEK) of the TR-31 wrapped encryption key material. The incoming wrapped key shall have a key purpose of D0 with a mode of use of B or D. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/use-cases-acquirers-dynamickeys.html">Using Dynamic Keys</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>For symmetric and DUKPT encryption, Amazon Web Services Payment Cryptography supports <code>TDES</code> and <code>AES</code> algorithms. To encrypt using DUKPT, a DUKPT key must already exist within your account with <code>KeyModesOfUse</code> set to <code>DeriveKey</code> or a new DUKPT can be generated by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html">CreateKey</a>.</p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation supports cross-account use when the key has a resource-based policy that grants access. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/security_iam_resource-based-policies.html">Resource-based policies</a>.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>DecryptData</a> </p> </li> <li> <p> <a>EncryptData</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_GetPublicKeyCertificate.html">GetPublicCertificate</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ImportKey.html">ImportKey</a> </p> </li> </ul>
|
|
33
33
|
* @example
|
|
34
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
35
|
* ```javascript
|
|
@@ -29,7 +29,7 @@ declare const TranslateKeyMaterialCommand_base: {
|
|
|
29
29
|
};
|
|
30
30
|
};
|
|
31
31
|
/**
|
|
32
|
-
* <p>Translates an cryptographic key between different wrapping keys without importing the key into Amazon Web Services Payment Cryptography.</p> <p>This operation can be used when key material is frequently rotated, such as during every card transaction, and there is a need to avoid importing short-lived keys into Amazon Web Services Payment Cryptography. It translates short-lived transaction keys such as <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/terminology.html#terms.pek">PEK</a> generated for each transaction and wrapped with an <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/terminology.html#terms.ecdh">ECDH</a> derived wrapping key to another <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/terminology.html#terms.kek">KEK</a> wrapping key. </p> <p>Before using this operation, you must first request the public key certificate of the ECC key pair generated within Amazon Web Services Payment Cryptography to establish an ECDH key agreement. In <code>TranslateKeyData</code>, the service uses its own ECC key pair, public certificate of receiving ECC key pair, and the key derivation parameters to generate a derived key. The service uses this derived key to unwrap the incoming transaction key received as a TR31WrappedKeyBlock and re-wrap using a user provided KEK to generate an outgoing Tr31WrappedKeyBlock.</p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation
|
|
32
|
+
* <p>Translates an cryptographic key between different wrapping keys without importing the key into Amazon Web Services Payment Cryptography.</p> <p>This operation can be used when key material is frequently rotated, such as during every card transaction, and there is a need to avoid importing short-lived keys into Amazon Web Services Payment Cryptography. It translates short-lived transaction keys such as <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/terminology.html#terms.pek">PEK</a> generated for each transaction and wrapped with an <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/terminology.html#terms.ecdh">ECDH</a> derived wrapping key to another <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/terminology.html#terms.kek">KEK</a> wrapping key. </p> <p>Before using this operation, you must first request the public key certificate of the ECC key pair generated within Amazon Web Services Payment Cryptography to establish an ECDH key agreement. In <code>TranslateKeyData</code>, the service uses its own ECC key pair, public certificate of receiving ECC key pair, and the key derivation parameters to generate a derived key. The service uses this derived key to unwrap the incoming transaction key received as a TR31WrappedKeyBlock and re-wrap using a user provided KEK to generate an outgoing Tr31WrappedKeyBlock.</p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation supports cross-account use when the key has a resource-based policy that grants access. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/security_iam_resource-based-policies.html">Resource-based policies</a>.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html">CreateKey</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_GetPublicKeyCertificate.html">GetPublicCertificate</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ImportKey.html">ImportKey</a> </p> </li> </ul>
|
|
33
33
|
* @example
|
|
34
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
35
|
* ```javascript
|
|
@@ -29,7 +29,7 @@ declare const TranslatePinDataCommand_base: {
|
|
|
29
29
|
};
|
|
30
30
|
};
|
|
31
31
|
/**
|
|
32
|
-
* <p>Translates encrypted PIN block from and to ISO 9564 formats 0,1,3,4. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/translate-pin-data.html">Translate PIN data</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>PIN block translation involves changing a PIN block from one encryption key to another and optionally change its format. PIN block translation occurs entirely within the HSM boundary and PIN data never enters or leaves Amazon Web Services Payment Cryptography in clear text. The encryption key transformation can be from PEK (Pin Encryption Key) to BDK (Base Derivation Key) for DUKPT or from BDK for DUKPT to PEK.</p> <p>Amazon Web Services Payment Cryptography also supports use of dynamic keys and ECDH (Elliptic Curve Diffie-Hellman) based key exchange for this operation.</p> <p>Dynamic keys allow you to pass a PEK as a TR-31 WrappedKeyBlock. They can be used when key material is frequently rotated, such as during every card transaction, and there is need to avoid importing short-lived keys into Amazon Web Services Payment Cryptography. To translate PIN block using dynamic keys, the <code>keyARN</code> is the Key Encryption Key (KEK) of the TR-31 wrapped PEK. The incoming wrapped key shall have a key purpose of P0 with a mode of use of B or D. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/use-cases-acquirers-dynamickeys.html">Using Dynamic Keys</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>Using ECDH key exchange, you can receive cardholder selectable PINs into Amazon Web Services Payment Cryptography. The ECDH derived key protects the incoming PIN block, which is translated to a PEK encrypted PIN block for use within the service. You can also use ECDH for reveal PIN, wherein the service translates the PIN block from PEK to a ECDH derived encryption key. For more information on establishing ECDH derived keys, see the <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/create-keys.html">Creating keys</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>The allowed combinations of PIN block format translations are guided by PCI. It is important to note that not all encrypted PIN block formats (example, format 1) require PAN (Primary Account Number) as input. And as such, PIN block format that requires PAN (example, formats 0,3,4) cannot be translated to a format (format 1) that does not require a PAN for generation. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <note> <p>Amazon Web Services Payment Cryptography currently supports ISO PIN block 4 translation for PIN block built using legacy PAN length. That is, PAN is the right most 12 digits excluding the check digits.</p> </note> <p> <b>Cross-account use</b>: This operation
|
|
32
|
+
* <p>Translates encrypted PIN block from and to ISO 9564 formats 0,1,3,4. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/translate-pin-data.html">Translate PIN data</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>PIN block translation involves changing a PIN block from one encryption key to another and optionally change its format. PIN block translation occurs entirely within the HSM boundary and PIN data never enters or leaves Amazon Web Services Payment Cryptography in clear text. The encryption key transformation can be from PEK (Pin Encryption Key) to BDK (Base Derivation Key) for DUKPT or from BDK for DUKPT to PEK.</p> <p>Amazon Web Services Payment Cryptography also supports use of dynamic keys and ECDH (Elliptic Curve Diffie-Hellman) based key exchange for this operation.</p> <p>Dynamic keys allow you to pass a PEK as a TR-31 WrappedKeyBlock. They can be used when key material is frequently rotated, such as during every card transaction, and there is need to avoid importing short-lived keys into Amazon Web Services Payment Cryptography. To translate PIN block using dynamic keys, the <code>keyARN</code> is the Key Encryption Key (KEK) of the TR-31 wrapped PEK. The incoming wrapped key shall have a key purpose of P0 with a mode of use of B or D. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/use-cases-acquirers-dynamickeys.html">Using Dynamic Keys</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>Using ECDH key exchange, you can receive cardholder selectable PINs into Amazon Web Services Payment Cryptography. The ECDH derived key protects the incoming PIN block, which is translated to a PEK encrypted PIN block for use within the service. You can also use ECDH for reveal PIN, wherein the service translates the PIN block from PEK to a ECDH derived encryption key. For more information on establishing ECDH derived keys, see the <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/create-keys.html">Creating keys</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>The allowed combinations of PIN block format translations are guided by PCI. It is important to note that not all encrypted PIN block formats (example, format 1) require PAN (Primary Account Number) as input. And as such, PIN block format that requires PAN (example, formats 0,3,4) cannot be translated to a format (format 1) that does not require a PAN for generation. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <note> <p>Amazon Web Services Payment Cryptography currently supports ISO PIN block 4 translation for PIN block built using legacy PAN length. That is, PAN is the right most 12 digits excluding the check digits.</p> </note> <p> <b>Cross-account use</b>: This operation supports cross-account use when the key has a resource-based policy that grants access. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/security_iam_resource-based-policies.html">Resource-based policies</a>.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>GeneratePinData</a> </p> </li> <li> <p> <a>VerifyPinData</a> </p> </li> </ul>
|
|
33
33
|
* @example
|
|
34
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
35
|
* ```javascript
|
|
@@ -29,7 +29,7 @@ declare const VerifyAuthRequestCryptogramCommand_base: {
|
|
|
29
29
|
};
|
|
30
30
|
};
|
|
31
31
|
/**
|
|
32
|
-
* <p>Verifies Authorization Request Cryptogram (ARQC) for a EMV chip payment card authorization. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/data-operations.verifyauthrequestcryptogram.html">Verify auth request cryptogram</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>ARQC generation is done outside of Amazon Web Services Payment Cryptography and is typically generated on a point of sale terminal for an EMV chip card to obtain payment authorization during transaction time. For ARQC verification, you must first import the ARQC generated outside of Amazon Web Services Payment Cryptography by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ImportKey.html">ImportKey</a>. This operation uses the imported ARQC and an major encryption key (DUKPT) created by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html">CreateKey</a> to either provide a boolean ARQC verification result or provide an APRC (Authorization Response Cryptogram) response using Method 1 or Method 2. The <code>ARPC_METHOD_1</code> uses <code>AuthResponseCode</code> to generate ARPC and <code>ARPC_METHOD_2</code> uses <code>CardStatusUpdate</code> to generate ARPC. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p> <b>Cross-account use</b>: This operation
|
|
32
|
+
* <p>Verifies Authorization Request Cryptogram (ARQC) for a EMV chip payment card authorization. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/data-operations.verifyauthrequestcryptogram.html">Verify auth request cryptogram</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>ARQC generation is done outside of Amazon Web Services Payment Cryptography and is typically generated on a point of sale terminal for an EMV chip card to obtain payment authorization during transaction time. For ARQC verification, you must first import the ARQC generated outside of Amazon Web Services Payment Cryptography by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ImportKey.html">ImportKey</a>. This operation uses the imported ARQC and an major encryption key (DUKPT) created by calling <a href="https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html">CreateKey</a> to either provide a boolean ARQC verification result or provide an APRC (Authorization Response Cryptogram) response using Method 1 or Method 2. The <code>ARPC_METHOD_1</code> uses <code>AuthResponseCode</code> to generate ARPC and <code>ARPC_METHOD_2</code> uses <code>CardStatusUpdate</code> to generate ARPC. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p> <b>Cross-account use</b>: This operation supports cross-account use when the key has a resource-based policy that grants access. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/security_iam_resource-based-policies.html">Resource-based policies</a>.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>VerifyCardValidationData</a> </p> </li> <li> <p> <a>VerifyPinData</a> </p> </li> </ul>
|
|
33
33
|
* @example
|
|
34
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
35
|
* ```javascript
|
|
@@ -29,7 +29,7 @@ declare const VerifyCardValidationDataCommand_base: {
|
|
|
29
29
|
};
|
|
30
30
|
};
|
|
31
31
|
/**
|
|
32
|
-
* <p>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). For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-card-data.html">Verify card data</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>This operation validates the CVV or CSC codes that is printed on a payment credit or debit card during card payment transaction. The input values are typically provided as part of an inbound transaction to an issuer or supporting platform partner. Amazon Web Services Payment Cryptography uses CVV or CSC, PAN (Primary Account Number) and expiration date of the card to check its validity during transaction processing. In this operation, the CVK (Card Verification Key) encryption key for use with card data verification is same as the one in used for <a>GenerateCardValidationData</a>. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation
|
|
32
|
+
* <p>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). For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-card-data.html">Verify card data</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>This operation validates the CVV or CSC codes that is printed on a payment credit or debit card during card payment transaction. The input values are typically provided as part of an inbound transaction to an issuer or supporting platform partner. Amazon Web Services Payment Cryptography uses CVV or CSC, PAN (Primary Account Number) and expiration date of the card to check its validity during transaction processing. In this operation, the CVK (Card Verification Key) encryption key for use with card data verification is same as the one in used for <a>GenerateCardValidationData</a>. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation supports cross-account use when the key has a resource-based policy that grants access. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/security_iam_resource-based-policies.html">Resource-based policies</a>.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>GenerateCardValidationData</a> </p> </li> <li> <p> <a>VerifyAuthRequestCryptogram</a> </p> </li> <li> <p> <a>VerifyPinData</a> </p> </li> </ul>
|
|
33
33
|
* @example
|
|
34
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
35
|
* ```javascript
|
|
@@ -29,7 +29,7 @@ declare const VerifyMacCommand_base: {
|
|
|
29
29
|
};
|
|
30
30
|
};
|
|
31
31
|
/**
|
|
32
|
-
* <p>Verifies a Message Authentication Code (MAC). </p> <p>You can use this operation to verify MAC for message data authentication such as . In this operation, you must use the same message data, secret encryption key and MAC algorithm that was used to generate MAC. You can use this operation to verify a DUPKT, CMAC, HMAC or EMV MAC by setting generation attributes and algorithm to the associated values. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation
|
|
32
|
+
* <p>Verifies a Message Authentication Code (MAC). </p> <p>You can use this operation to verify MAC for message data authentication such as . In this operation, you must use the same message data, secret encryption key and MAC algorithm that was used to generate MAC. You can use this operation to verify a DUPKT, CMAC, HMAC or EMV MAC by setting generation attributes and algorithm to the associated values. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation supports cross-account use when the key has a resource-based policy that grants access. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/security_iam_resource-based-policies.html">Resource-based policies</a>.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>GenerateMac</a> </p> </li> </ul>
|
|
33
33
|
* @example
|
|
34
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
35
|
* ```javascript
|
|
@@ -29,7 +29,7 @@ declare const VerifyPinDataCommand_base: {
|
|
|
29
29
|
};
|
|
30
30
|
};
|
|
31
31
|
/**
|
|
32
|
-
* <p>Verifies pin-related data such as PIN and PIN Offset using algorithms including VISA PVV and IBM3624. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-pin-data.html">Verify PIN data</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>This operation verifies PIN data for user payment card. A card holder PIN data is never transmitted in clear to or from Amazon Web Services Payment Cryptography. This operation uses PIN Verification Key (PVK) for PIN or PIN Offset generation and then encrypts it using PIN Encryption Key (PEK) to create an <code>EncryptedPinBlock</code> for transmission from Amazon Web Services Payment Cryptography. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation
|
|
32
|
+
* <p>Verifies pin-related data such as PIN and PIN Offset using algorithms including VISA PVV and IBM3624. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-pin-data.html">Verify PIN data</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>.</p> <p>This operation verifies PIN data for user payment card. A card holder PIN data is never transmitted in clear to or from Amazon Web Services Payment Cryptography. This operation uses PIN Verification Key (PVK) for PIN or PIN Offset generation and then encrypts it using PIN Encryption Key (PEK) to create an <code>EncryptedPinBlock</code> for transmission from Amazon Web Services Payment Cryptography. </p> <p>For information about valid keys for this operation, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html">Understanding key attributes</a> and <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops-validkeys-ops.html">Key types for specific data operations</a> in the <i>Amazon Web Services Payment Cryptography User Guide</i>. </p> <p> <b>Cross-account use</b>: This operation supports cross-account use when the key has a resource-based policy that grants access. For more information, see <a href="https://docs.aws.amazon.com/payment-cryptography/latest/userguide/security_iam_resource-based-policies.html">Resource-based policies</a>.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>GeneratePinData</a> </p> </li> <li> <p> <a>TranslatePinData</a> </p> </li> </ul>
|
|
33
33
|
* @example
|
|
34
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
35
|
* ```javascript
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
export * from "./DecryptDataCommand";
|
|
2
2
|
export * from "./EncryptDataCommand";
|
|
3
3
|
export * from "./GenerateAs2805KekValidationCommand";
|
|
4
|
+
export * from "./GenerateAuthRequestCryptogramCommand";
|
|
4
5
|
export * from "./GenerateCardValidationDataCommand";
|
|
5
6
|
export * from "./GenerateMacCommand";
|
|
6
7
|
export * from "./GenerateMacEmvPinChangeCommand";
|
|
@@ -29,6 +29,19 @@ export declare const SymmetricKeyAlgorithm: {
|
|
|
29
29
|
* @public
|
|
30
30
|
*/
|
|
31
31
|
export type SymmetricKeyAlgorithm = (typeof SymmetricKeyAlgorithm)[keyof typeof SymmetricKeyAlgorithm];
|
|
32
|
+
/**
|
|
33
|
+
* @public
|
|
34
|
+
* @enum
|
|
35
|
+
*/
|
|
36
|
+
export declare const RandomKeyMaxLength: {
|
|
37
|
+
readonly BYTES_16: "BYTES_16";
|
|
38
|
+
readonly BYTES_24: "BYTES_24";
|
|
39
|
+
readonly BYTES_8: "BYTES_8";
|
|
40
|
+
};
|
|
41
|
+
/**
|
|
42
|
+
* @public
|
|
43
|
+
*/
|
|
44
|
+
export type RandomKeyMaxLength = (typeof RandomKeyMaxLength)[keyof typeof RandomKeyMaxLength];
|
|
32
45
|
/**
|
|
33
46
|
* @public
|
|
34
47
|
* @enum
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { DukptDerivationType, DukptEncryptionMode, DukptKeyVariant, EmvEncryptionMode, EmvMajorKeyDerivationMode, EncryptionMode, KeyCheckValueAlgorithm, KeyDerivationFunction, KeyDerivationHashAlgorithm, MacAlgorithm, MajorKeyDerivationMode, PaddingType, PinBlockFormatForEmvPinChange, PinBlockFormatForPinData, PinBlockLengthPosition, PinBlockPaddingType, RandomKeySendVariantMask, SessionKeyDerivationMode, SymmetricKeyAlgorithm, WrappedKeyMaterialFormat } from "./enums";
|
|
1
|
+
import type { DukptDerivationType, DukptEncryptionMode, DukptKeyVariant, EmvEncryptionMode, EmvMajorKeyDerivationMode, EncryptionMode, KeyCheckValueAlgorithm, KeyDerivationFunction, KeyDerivationHashAlgorithm, MacAlgorithm, MajorKeyDerivationMode, PaddingType, PinBlockFormatForEmvPinChange, PinBlockFormatForPinData, PinBlockLengthPosition, PinBlockPaddingType, RandomKeyMaxLength, RandomKeySendVariantMask, SessionKeyDerivationMode, SymmetricKeyAlgorithm, WrappedKeyMaterialFormat } from "./enums";
|
|
2
2
|
/**
|
|
3
3
|
* <p>The parameter values of the current PIN to be changed on the EMV chip card.</p>
|
|
4
4
|
* @public
|
|
@@ -88,6 +88,11 @@ export interface KekValidationRequest {
|
|
|
88
88
|
* @public
|
|
89
89
|
*/
|
|
90
90
|
DeriveKeyAlgorithm: SymmetricKeyAlgorithm | undefined;
|
|
91
|
+
/**
|
|
92
|
+
* <p>The maximum length of the random key to generate for a KEK validation request.</p>
|
|
93
|
+
* @public
|
|
94
|
+
*/
|
|
95
|
+
RandomKeyMaxLength?: RandomKeyMaxLength | undefined;
|
|
91
96
|
}
|
|
92
97
|
/**
|
|
93
98
|
* <p>Parameter information for generating a KEK validation response during node-to-node initialization.</p>
|
|
@@ -95,7 +100,7 @@ export interface KekValidationRequest {
|
|
|
95
100
|
*/
|
|
96
101
|
export interface KekValidationResponse {
|
|
97
102
|
/**
|
|
98
|
-
* <p>The random key
|
|
103
|
+
* <p>The random key send value received from the initiating node to generate a KEK validation response.</p>
|
|
99
104
|
* @public
|
|
100
105
|
*/
|
|
101
106
|
RandomKeySend: string | undefined;
|
|
@@ -1327,7 +1332,7 @@ export interface GenerateAs2805KekValidationInput {
|
|
|
1327
1332
|
*/
|
|
1328
1333
|
KeyIdentifier: string | undefined;
|
|
1329
1334
|
/**
|
|
1330
|
-
* <p>
|
|
1335
|
+
* <p>Defines whether to generate a KEK validation request or KEK validation response for node-to-node initialization.</p>
|
|
1331
1336
|
* @public
|
|
1332
1337
|
*/
|
|
1333
1338
|
KekValidationType: As2805KekValidationType | undefined;
|
|
@@ -1362,6 +1367,244 @@ export interface GenerateAs2805KekValidationOutput {
|
|
|
1362
1367
|
*/
|
|
1363
1368
|
RandomKeyReceive: string | undefined;
|
|
1364
1369
|
}
|
|
1370
|
+
/**
|
|
1371
|
+
* <p>Parameters to derive session key for an Amex payment card.</p>
|
|
1372
|
+
* @public
|
|
1373
|
+
*/
|
|
1374
|
+
export interface SessionKeyAmex {
|
|
1375
|
+
/**
|
|
1376
|
+
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
1377
|
+
* @public
|
|
1378
|
+
*/
|
|
1379
|
+
PrimaryAccountNumber: string | undefined;
|
|
1380
|
+
/**
|
|
1381
|
+
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
1382
|
+
* @public
|
|
1383
|
+
*/
|
|
1384
|
+
PanSequenceNumber: string | undefined;
|
|
1385
|
+
}
|
|
1386
|
+
/**
|
|
1387
|
+
* <p>Parameters to derive session key for an Emv2000 payment card for ARQC verification.</p>
|
|
1388
|
+
* @public
|
|
1389
|
+
*/
|
|
1390
|
+
export interface SessionKeyEmv2000 {
|
|
1391
|
+
/**
|
|
1392
|
+
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
1393
|
+
* @public
|
|
1394
|
+
*/
|
|
1395
|
+
PrimaryAccountNumber: string | undefined;
|
|
1396
|
+
/**
|
|
1397
|
+
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
1398
|
+
* @public
|
|
1399
|
+
*/
|
|
1400
|
+
PanSequenceNumber: string | undefined;
|
|
1401
|
+
/**
|
|
1402
|
+
* <p>The transaction counter that is provided by the terminal during transaction processing.</p>
|
|
1403
|
+
* @public
|
|
1404
|
+
*/
|
|
1405
|
+
ApplicationTransactionCounter: string | undefined;
|
|
1406
|
+
}
|
|
1407
|
+
/**
|
|
1408
|
+
* <p>Parameters to derive session key for an Emv common payment card for ARQC verification.</p>
|
|
1409
|
+
* @public
|
|
1410
|
+
*/
|
|
1411
|
+
export interface SessionKeyEmvCommon {
|
|
1412
|
+
/**
|
|
1413
|
+
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
1414
|
+
* @public
|
|
1415
|
+
*/
|
|
1416
|
+
PrimaryAccountNumber: string | undefined;
|
|
1417
|
+
/**
|
|
1418
|
+
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
1419
|
+
* @public
|
|
1420
|
+
*/
|
|
1421
|
+
PanSequenceNumber: string | undefined;
|
|
1422
|
+
/**
|
|
1423
|
+
* <p>The transaction counter that is provided by the terminal during transaction processing.</p>
|
|
1424
|
+
* @public
|
|
1425
|
+
*/
|
|
1426
|
+
ApplicationTransactionCounter: string | undefined;
|
|
1427
|
+
}
|
|
1428
|
+
/**
|
|
1429
|
+
* <p>Parameters to derive session key for Mastercard payment card for ARQC verification.</p>
|
|
1430
|
+
* @public
|
|
1431
|
+
*/
|
|
1432
|
+
export interface SessionKeyMastercard {
|
|
1433
|
+
/**
|
|
1434
|
+
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
1435
|
+
* @public
|
|
1436
|
+
*/
|
|
1437
|
+
PrimaryAccountNumber: string | undefined;
|
|
1438
|
+
/**
|
|
1439
|
+
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
1440
|
+
* @public
|
|
1441
|
+
*/
|
|
1442
|
+
PanSequenceNumber: string | undefined;
|
|
1443
|
+
/**
|
|
1444
|
+
* <p>The transaction counter that is provided by the terminal during transaction processing.</p>
|
|
1445
|
+
* @public
|
|
1446
|
+
*/
|
|
1447
|
+
ApplicationTransactionCounter: string | undefined;
|
|
1448
|
+
/**
|
|
1449
|
+
* <p>A random number generated by the issuer.</p>
|
|
1450
|
+
* @public
|
|
1451
|
+
*/
|
|
1452
|
+
UnpredictableNumber: string | undefined;
|
|
1453
|
+
}
|
|
1454
|
+
/**
|
|
1455
|
+
* <p>Parameters to derive session key for Visa payment card for ARQC verification.</p>
|
|
1456
|
+
* @public
|
|
1457
|
+
*/
|
|
1458
|
+
export interface SessionKeyVisa {
|
|
1459
|
+
/**
|
|
1460
|
+
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
1461
|
+
* @public
|
|
1462
|
+
*/
|
|
1463
|
+
PrimaryAccountNumber: string | undefined;
|
|
1464
|
+
/**
|
|
1465
|
+
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
1466
|
+
* @public
|
|
1467
|
+
*/
|
|
1468
|
+
PanSequenceNumber: string | undefined;
|
|
1469
|
+
}
|
|
1470
|
+
/**
|
|
1471
|
+
* <p>Parameters to derive a session key for Authorization Response Cryptogram (ARQC) verification.</p>
|
|
1472
|
+
* @public
|
|
1473
|
+
*/
|
|
1474
|
+
export type SessionKeyDerivation = SessionKeyDerivation.AmexMember | SessionKeyDerivation.Emv2000Member | SessionKeyDerivation.EmvCommonMember | SessionKeyDerivation.MastercardMember | SessionKeyDerivation.VisaMember | SessionKeyDerivation.$UnknownMember;
|
|
1475
|
+
/**
|
|
1476
|
+
* @public
|
|
1477
|
+
*/
|
|
1478
|
+
export declare namespace SessionKeyDerivation {
|
|
1479
|
+
/**
|
|
1480
|
+
* <p>Parameters to derive session key for an Emv common payment card for ARQC verification.</p>
|
|
1481
|
+
* @public
|
|
1482
|
+
*/
|
|
1483
|
+
interface EmvCommonMember {
|
|
1484
|
+
EmvCommon: SessionKeyEmvCommon;
|
|
1485
|
+
Mastercard?: never;
|
|
1486
|
+
Emv2000?: never;
|
|
1487
|
+
Amex?: never;
|
|
1488
|
+
Visa?: never;
|
|
1489
|
+
$unknown?: never;
|
|
1490
|
+
}
|
|
1491
|
+
/**
|
|
1492
|
+
* <p>Parameters to derive session key for a Mastercard payment card for ARQC verification.</p>
|
|
1493
|
+
* @public
|
|
1494
|
+
*/
|
|
1495
|
+
interface MastercardMember {
|
|
1496
|
+
EmvCommon?: never;
|
|
1497
|
+
Mastercard: SessionKeyMastercard;
|
|
1498
|
+
Emv2000?: never;
|
|
1499
|
+
Amex?: never;
|
|
1500
|
+
Visa?: never;
|
|
1501
|
+
$unknown?: never;
|
|
1502
|
+
}
|
|
1503
|
+
/**
|
|
1504
|
+
* <p>Parameters to derive session key for an Emv2000 payment card for ARQC verification.</p>
|
|
1505
|
+
* @public
|
|
1506
|
+
*/
|
|
1507
|
+
interface Emv2000Member {
|
|
1508
|
+
EmvCommon?: never;
|
|
1509
|
+
Mastercard?: never;
|
|
1510
|
+
Emv2000: SessionKeyEmv2000;
|
|
1511
|
+
Amex?: never;
|
|
1512
|
+
Visa?: never;
|
|
1513
|
+
$unknown?: never;
|
|
1514
|
+
}
|
|
1515
|
+
/**
|
|
1516
|
+
* <p>Parameters to derive session key for an Amex payment card for ARQC verification.</p>
|
|
1517
|
+
* @public
|
|
1518
|
+
*/
|
|
1519
|
+
interface AmexMember {
|
|
1520
|
+
EmvCommon?: never;
|
|
1521
|
+
Mastercard?: never;
|
|
1522
|
+
Emv2000?: never;
|
|
1523
|
+
Amex: SessionKeyAmex;
|
|
1524
|
+
Visa?: never;
|
|
1525
|
+
$unknown?: never;
|
|
1526
|
+
}
|
|
1527
|
+
/**
|
|
1528
|
+
* <p>Parameters to derive session key for a Visa payment cardfor ARQC verification.</p>
|
|
1529
|
+
* @public
|
|
1530
|
+
*/
|
|
1531
|
+
interface VisaMember {
|
|
1532
|
+
EmvCommon?: never;
|
|
1533
|
+
Mastercard?: never;
|
|
1534
|
+
Emv2000?: never;
|
|
1535
|
+
Amex?: never;
|
|
1536
|
+
Visa: SessionKeyVisa;
|
|
1537
|
+
$unknown?: never;
|
|
1538
|
+
}
|
|
1539
|
+
/**
|
|
1540
|
+
* @public
|
|
1541
|
+
*/
|
|
1542
|
+
interface $UnknownMember {
|
|
1543
|
+
EmvCommon?: never;
|
|
1544
|
+
Mastercard?: never;
|
|
1545
|
+
Emv2000?: never;
|
|
1546
|
+
Amex?: never;
|
|
1547
|
+
Visa?: never;
|
|
1548
|
+
$unknown: [string, any];
|
|
1549
|
+
}
|
|
1550
|
+
/**
|
|
1551
|
+
* @deprecated unused in schema-serde mode.
|
|
1552
|
+
*
|
|
1553
|
+
*/
|
|
1554
|
+
interface Visitor<T> {
|
|
1555
|
+
EmvCommon: (value: SessionKeyEmvCommon) => T;
|
|
1556
|
+
Mastercard: (value: SessionKeyMastercard) => T;
|
|
1557
|
+
Emv2000: (value: SessionKeyEmv2000) => T;
|
|
1558
|
+
Amex: (value: SessionKeyAmex) => T;
|
|
1559
|
+
Visa: (value: SessionKeyVisa) => T;
|
|
1560
|
+
_: (name: string, value: any) => T;
|
|
1561
|
+
}
|
|
1562
|
+
}
|
|
1563
|
+
/**
|
|
1564
|
+
* @public
|
|
1565
|
+
*/
|
|
1566
|
+
export interface GenerateAuthRequestCryptogramInput {
|
|
1567
|
+
/**
|
|
1568
|
+
* <p>The <code>keyARN</code> of the IMK-AC (TR31_E0_EMV_MKEY_APP_CRYPTOGRAMS) that Amazon Web Services Payment Cryptography uses to generate the ARQC.</p>
|
|
1569
|
+
* @public
|
|
1570
|
+
*/
|
|
1571
|
+
KeyIdentifier: string | undefined;
|
|
1572
|
+
/**
|
|
1573
|
+
* <p>The transaction data that Amazon Web Services Payment Cryptography uses for ARQC generation. The same transaction data is used for ARQC verification by the issuer using <a>VerifyAuthRequestCryptogram</a>.</p>
|
|
1574
|
+
* @public
|
|
1575
|
+
*/
|
|
1576
|
+
TransactionData: string | undefined;
|
|
1577
|
+
/**
|
|
1578
|
+
* <p>The method to use when deriving the major encryption key for ARQC generation within Amazon Web Services Payment Cryptography.</p>
|
|
1579
|
+
* @public
|
|
1580
|
+
*/
|
|
1581
|
+
MajorKeyDerivationMode: MajorKeyDerivationMode | undefined;
|
|
1582
|
+
/**
|
|
1583
|
+
* <p>The attributes and values to use for deriving a session key for ARQC generation within Amazon Web Services Payment Cryptography.</p>
|
|
1584
|
+
* @public
|
|
1585
|
+
*/
|
|
1586
|
+
SessionKeyDerivationAttributes: SessionKeyDerivation | undefined;
|
|
1587
|
+
}
|
|
1588
|
+
/**
|
|
1589
|
+
* @public
|
|
1590
|
+
*/
|
|
1591
|
+
export interface GenerateAuthRequestCryptogramOutput {
|
|
1592
|
+
/**
|
|
1593
|
+
* <p>The <code>keyARN</code> of the IMK-AC that Amazon Web Services Payment Cryptography uses for ARQC generation.</p>
|
|
1594
|
+
* @public
|
|
1595
|
+
*/
|
|
1596
|
+
KeyArn: string | undefined;
|
|
1597
|
+
/**
|
|
1598
|
+
* <p>The key check value (KCV) of the encryption key. The KCV is used to check if all parties holding a given key have the same key or to detect that a key has changed.</p> <p>Amazon Web Services Payment Cryptography computes the KCV according to the CMAC specification.</p>
|
|
1599
|
+
* @public
|
|
1600
|
+
*/
|
|
1601
|
+
KeyCheckValue: string | undefined;
|
|
1602
|
+
/**
|
|
1603
|
+
* <p>The Authorization Request Cryptogram (ARQC) generated by Amazon Web Services Payment Cryptography using the specified key and transaction data.</p>
|
|
1604
|
+
* @public
|
|
1605
|
+
*/
|
|
1606
|
+
AuthRequestCryptogram: string | undefined;
|
|
1607
|
+
}
|
|
1365
1608
|
/**
|
|
1366
1609
|
* @public
|
|
1367
1610
|
*/
|
|
@@ -2613,199 +2856,6 @@ export interface TranslatePinDataOutput {
|
|
|
2613
2856
|
*/
|
|
2614
2857
|
KeyCheckValue: string | undefined;
|
|
2615
2858
|
}
|
|
2616
|
-
/**
|
|
2617
|
-
* <p>Parameters to derive session key for an Amex payment card.</p>
|
|
2618
|
-
* @public
|
|
2619
|
-
*/
|
|
2620
|
-
export interface SessionKeyAmex {
|
|
2621
|
-
/**
|
|
2622
|
-
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
2623
|
-
* @public
|
|
2624
|
-
*/
|
|
2625
|
-
PrimaryAccountNumber: string | undefined;
|
|
2626
|
-
/**
|
|
2627
|
-
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
2628
|
-
* @public
|
|
2629
|
-
*/
|
|
2630
|
-
PanSequenceNumber: string | undefined;
|
|
2631
|
-
}
|
|
2632
|
-
/**
|
|
2633
|
-
* <p>Parameters to derive session key for an Emv2000 payment card for ARQC verification.</p>
|
|
2634
|
-
* @public
|
|
2635
|
-
*/
|
|
2636
|
-
export interface SessionKeyEmv2000 {
|
|
2637
|
-
/**
|
|
2638
|
-
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
2639
|
-
* @public
|
|
2640
|
-
*/
|
|
2641
|
-
PrimaryAccountNumber: string | undefined;
|
|
2642
|
-
/**
|
|
2643
|
-
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
2644
|
-
* @public
|
|
2645
|
-
*/
|
|
2646
|
-
PanSequenceNumber: string | undefined;
|
|
2647
|
-
/**
|
|
2648
|
-
* <p>The transaction counter that is provided by the terminal during transaction processing.</p>
|
|
2649
|
-
* @public
|
|
2650
|
-
*/
|
|
2651
|
-
ApplicationTransactionCounter: string | undefined;
|
|
2652
|
-
}
|
|
2653
|
-
/**
|
|
2654
|
-
* <p>Parameters to derive session key for an Emv common payment card for ARQC verification.</p>
|
|
2655
|
-
* @public
|
|
2656
|
-
*/
|
|
2657
|
-
export interface SessionKeyEmvCommon {
|
|
2658
|
-
/**
|
|
2659
|
-
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
2660
|
-
* @public
|
|
2661
|
-
*/
|
|
2662
|
-
PrimaryAccountNumber: string | undefined;
|
|
2663
|
-
/**
|
|
2664
|
-
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
2665
|
-
* @public
|
|
2666
|
-
*/
|
|
2667
|
-
PanSequenceNumber: string | undefined;
|
|
2668
|
-
/**
|
|
2669
|
-
* <p>The transaction counter that is provided by the terminal during transaction processing.</p>
|
|
2670
|
-
* @public
|
|
2671
|
-
*/
|
|
2672
|
-
ApplicationTransactionCounter: string | undefined;
|
|
2673
|
-
}
|
|
2674
|
-
/**
|
|
2675
|
-
* <p>Parameters to derive session key for Mastercard payment card for ARQC verification.</p>
|
|
2676
|
-
* @public
|
|
2677
|
-
*/
|
|
2678
|
-
export interface SessionKeyMastercard {
|
|
2679
|
-
/**
|
|
2680
|
-
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
2681
|
-
* @public
|
|
2682
|
-
*/
|
|
2683
|
-
PrimaryAccountNumber: string | undefined;
|
|
2684
|
-
/**
|
|
2685
|
-
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
2686
|
-
* @public
|
|
2687
|
-
*/
|
|
2688
|
-
PanSequenceNumber: string | undefined;
|
|
2689
|
-
/**
|
|
2690
|
-
* <p>The transaction counter that is provided by the terminal during transaction processing.</p>
|
|
2691
|
-
* @public
|
|
2692
|
-
*/
|
|
2693
|
-
ApplicationTransactionCounter: string | undefined;
|
|
2694
|
-
/**
|
|
2695
|
-
* <p>A random number generated by the issuer.</p>
|
|
2696
|
-
* @public
|
|
2697
|
-
*/
|
|
2698
|
-
UnpredictableNumber: string | undefined;
|
|
2699
|
-
}
|
|
2700
|
-
/**
|
|
2701
|
-
* <p>Parameters to derive session key for Visa payment card for ARQC verification.</p>
|
|
2702
|
-
* @public
|
|
2703
|
-
*/
|
|
2704
|
-
export interface SessionKeyVisa {
|
|
2705
|
-
/**
|
|
2706
|
-
* <p>The Primary Account Number (PAN) of the cardholder. A PAN is a unique identifier for a payment credit or debit card and associates the card to a specific account holder.</p>
|
|
2707
|
-
* @public
|
|
2708
|
-
*/
|
|
2709
|
-
PrimaryAccountNumber: string | undefined;
|
|
2710
|
-
/**
|
|
2711
|
-
* <p>A number that identifies and differentiates payment cards with the same Primary Account Number (PAN).</p>
|
|
2712
|
-
* @public
|
|
2713
|
-
*/
|
|
2714
|
-
PanSequenceNumber: string | undefined;
|
|
2715
|
-
}
|
|
2716
|
-
/**
|
|
2717
|
-
* <p>Parameters to derive a session key for Authorization Response Cryptogram (ARQC) verification.</p>
|
|
2718
|
-
* @public
|
|
2719
|
-
*/
|
|
2720
|
-
export type SessionKeyDerivation = SessionKeyDerivation.AmexMember | SessionKeyDerivation.Emv2000Member | SessionKeyDerivation.EmvCommonMember | SessionKeyDerivation.MastercardMember | SessionKeyDerivation.VisaMember | SessionKeyDerivation.$UnknownMember;
|
|
2721
|
-
/**
|
|
2722
|
-
* @public
|
|
2723
|
-
*/
|
|
2724
|
-
export declare namespace SessionKeyDerivation {
|
|
2725
|
-
/**
|
|
2726
|
-
* <p>Parameters to derive session key for an Emv common payment card for ARQC verification.</p>
|
|
2727
|
-
* @public
|
|
2728
|
-
*/
|
|
2729
|
-
interface EmvCommonMember {
|
|
2730
|
-
EmvCommon: SessionKeyEmvCommon;
|
|
2731
|
-
Mastercard?: never;
|
|
2732
|
-
Emv2000?: never;
|
|
2733
|
-
Amex?: never;
|
|
2734
|
-
Visa?: never;
|
|
2735
|
-
$unknown?: never;
|
|
2736
|
-
}
|
|
2737
|
-
/**
|
|
2738
|
-
* <p>Parameters to derive session key for a Mastercard payment card for ARQC verification.</p>
|
|
2739
|
-
* @public
|
|
2740
|
-
*/
|
|
2741
|
-
interface MastercardMember {
|
|
2742
|
-
EmvCommon?: never;
|
|
2743
|
-
Mastercard: SessionKeyMastercard;
|
|
2744
|
-
Emv2000?: never;
|
|
2745
|
-
Amex?: never;
|
|
2746
|
-
Visa?: never;
|
|
2747
|
-
$unknown?: never;
|
|
2748
|
-
}
|
|
2749
|
-
/**
|
|
2750
|
-
* <p>Parameters to derive session key for an Emv2000 payment card for ARQC verification.</p>
|
|
2751
|
-
* @public
|
|
2752
|
-
*/
|
|
2753
|
-
interface Emv2000Member {
|
|
2754
|
-
EmvCommon?: never;
|
|
2755
|
-
Mastercard?: never;
|
|
2756
|
-
Emv2000: SessionKeyEmv2000;
|
|
2757
|
-
Amex?: never;
|
|
2758
|
-
Visa?: never;
|
|
2759
|
-
$unknown?: never;
|
|
2760
|
-
}
|
|
2761
|
-
/**
|
|
2762
|
-
* <p>Parameters to derive session key for an Amex payment card for ARQC verification.</p>
|
|
2763
|
-
* @public
|
|
2764
|
-
*/
|
|
2765
|
-
interface AmexMember {
|
|
2766
|
-
EmvCommon?: never;
|
|
2767
|
-
Mastercard?: never;
|
|
2768
|
-
Emv2000?: never;
|
|
2769
|
-
Amex: SessionKeyAmex;
|
|
2770
|
-
Visa?: never;
|
|
2771
|
-
$unknown?: never;
|
|
2772
|
-
}
|
|
2773
|
-
/**
|
|
2774
|
-
* <p>Parameters to derive session key for a Visa payment cardfor ARQC verification.</p>
|
|
2775
|
-
* @public
|
|
2776
|
-
*/
|
|
2777
|
-
interface VisaMember {
|
|
2778
|
-
EmvCommon?: never;
|
|
2779
|
-
Mastercard?: never;
|
|
2780
|
-
Emv2000?: never;
|
|
2781
|
-
Amex?: never;
|
|
2782
|
-
Visa: SessionKeyVisa;
|
|
2783
|
-
$unknown?: never;
|
|
2784
|
-
}
|
|
2785
|
-
/**
|
|
2786
|
-
* @public
|
|
2787
|
-
*/
|
|
2788
|
-
interface $UnknownMember {
|
|
2789
|
-
EmvCommon?: never;
|
|
2790
|
-
Mastercard?: never;
|
|
2791
|
-
Emv2000?: never;
|
|
2792
|
-
Amex?: never;
|
|
2793
|
-
Visa?: never;
|
|
2794
|
-
$unknown: [string, any];
|
|
2795
|
-
}
|
|
2796
|
-
/**
|
|
2797
|
-
* @deprecated unused in schema-serde mode.
|
|
2798
|
-
*
|
|
2799
|
-
*/
|
|
2800
|
-
interface Visitor<T> {
|
|
2801
|
-
EmvCommon: (value: SessionKeyEmvCommon) => T;
|
|
2802
|
-
Mastercard: (value: SessionKeyMastercard) => T;
|
|
2803
|
-
Emv2000: (value: SessionKeyEmv2000) => T;
|
|
2804
|
-
Amex: (value: SessionKeyAmex) => T;
|
|
2805
|
-
Visa: (value: SessionKeyVisa) => T;
|
|
2806
|
-
_: (name: string, value: any) => T;
|
|
2807
|
-
}
|
|
2808
|
-
}
|
|
2809
2859
|
/**
|
|
2810
2860
|
* @public
|
|
2811
2861
|
*/
|