@aws-sdk/client-payment-cryptography-data 3.1050.0 → 3.1052.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.
Files changed (37) hide show
  1. package/README.md +7 -0
  2. package/dist-cjs/index.js +20 -0
  3. package/dist-cjs/schemas/schemas_0.js +22 -5
  4. package/dist-es/PaymentCryptographyData.js +2 -0
  5. package/dist-es/commands/GenerateAuthRequestCryptogramCommand.js +16 -0
  6. package/dist-es/commands/index.js +1 -0
  7. package/dist-es/models/enums.js +5 -0
  8. package/dist-es/schemas/schemas_0.js +19 -2
  9. package/dist-types/PaymentCryptographyData.d.ts +7 -0
  10. package/dist-types/PaymentCryptographyDataClient.d.ts +3 -2
  11. package/dist-types/commands/DecryptDataCommand.d.ts +1 -1
  12. package/dist-types/commands/EncryptDataCommand.d.ts +1 -1
  13. package/dist-types/commands/GenerateAs2805KekValidationCommand.d.ts +2 -1
  14. package/dist-types/commands/GenerateAuthRequestCryptogramCommand.d.ts +121 -0
  15. package/dist-types/commands/GenerateCardValidationDataCommand.d.ts +1 -1
  16. package/dist-types/commands/GenerateMacCommand.d.ts +1 -1
  17. package/dist-types/commands/GenerateMacEmvPinChangeCommand.d.ts +1 -1
  18. package/dist-types/commands/GeneratePinDataCommand.d.ts +1 -1
  19. package/dist-types/commands/ReEncryptDataCommand.d.ts +1 -1
  20. package/dist-types/commands/TranslateKeyMaterialCommand.d.ts +1 -1
  21. package/dist-types/commands/TranslatePinDataCommand.d.ts +1 -1
  22. package/dist-types/commands/VerifyAuthRequestCryptogramCommand.d.ts +1 -1
  23. package/dist-types/commands/VerifyCardValidationDataCommand.d.ts +1 -1
  24. package/dist-types/commands/VerifyMacCommand.d.ts +1 -1
  25. package/dist-types/commands/VerifyPinDataCommand.d.ts +1 -1
  26. package/dist-types/commands/index.d.ts +1 -0
  27. package/dist-types/models/enums.d.ts +13 -0
  28. package/dist-types/models/models_0.d.ts +246 -196
  29. package/dist-types/schemas/schemas_0.d.ts +3 -0
  30. package/dist-types/ts3.4/PaymentCryptographyData.d.ts +17 -0
  31. package/dist-types/ts3.4/PaymentCryptographyDataClient.d.ts +6 -0
  32. package/dist-types/ts3.4/commands/GenerateAuthRequestCryptogramCommand.d.ts +53 -0
  33. package/dist-types/ts3.4/commands/index.d.ts +1 -0
  34. package/dist-types/ts3.4/models/enums.d.ts +7 -0
  35. package/dist-types/ts3.4/models/models_0.d.ts +102 -89
  36. package/dist-types/ts3.4/schemas/schemas_0.d.ts +3 -0
  37. package/package.json +8 -8
@@ -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 can't be used across different Amazon Web Services accounts.</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>
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 can't be used across different Amazon Web Services accounts.</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>
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 can't be used across different Amazon Web Services accounts.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>GeneratePinData</a> </p> </li> <li> <p> <a>VerifyPinData</a> </p> </li> </ul>
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 can't be used across different Amazon Web Services accounts.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>VerifyCardValidationData</a> </p> </li> <li> <p> <a>VerifyPinData</a> </p> </li> </ul>
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 can't be used across different Amazon Web Services accounts.</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>
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 can't be used across different Amazon Web Services accounts.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>GenerateMac</a> </p> </li> </ul>
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 can't be used across different Amazon Web Services accounts.</p> <p> <b>Related operations:</b> </p> <ul> <li> <p> <a>GeneratePinData</a> </p> </li> <li> <p> <a>TranslatePinData</a> </p> </li> </ul>
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 for generating a KEK validation response.</p>
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>Parameter information for generating a random key for KEK validation to perform node-to-node initialization.</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
  */