Visa Click to Pay

Interface Changes

The following changes were made to the interface:

• Added support to allow mobile phone number to be used for Consumer Identity in the checkout() and identityLookup() JavaScript methods. The consumerIdentity structure's contents have been modified.
• Added support to allow mobile phone number to be used for Masked Consumer Identity in the checkout() and getSrcProfile() JavaScript methods and Get Payload API. The maskedConsumerIdentity structure's contents have been modified.

Documentation Changes

The following changes were made to documentation:

• Clarified that the consumer parameter checkout() is conditional; required when linking a new card.
• Revised the values that can be in the dynamicDataType field of the PaymentOptions structure in the init() and checkout() parameters.
• Revised the values that can be in the dynamicDataType field of the dynamicData structure in the unencrypted payload.
• Added a "Checkout input when existing card is selected - Issuer OTP / Online Banking Version:" example for the checkout() API.
• Added "Requirements to Initiate Authentication" section to the checkout() API description.
• Provided additional information related to consumer identity in the "Requirements When Checking Out With a New Card" section of the checkout() API description.
• Revised verificationEntity field values.
• Added additional Method Results fields.
• Updated the Identity Lookup Example.

Documentation Changes

The following changes were made to documentation:

• Clarified that the windowRef checkout parameter is optional and provides additional context for the use of this parameter.
• Clarified that the authenticationMethods field is an array containing one or more authentication method structures.
• Clarified that the digitalCardData structure contains an authenticationMethods field, not an authenticationMethod field.
• Clarified that the status field's value in the Masked Consumer structure can be ACTIVE, SUSPENDED, or LOCKED.

Documentation Changes

The following changes were made to documentation:

• Clarified that the parameters provided to the identityLookup() method are in the consumerIdentity structure.
• Removed extraneous values from the type parameter in the consumerIdentity structure.
• Clarified that the name fields and mobile number field in the masked and raw Masked Consumer and Consumer structures are not returned by the getSrcProfile() method.
  
• Clarified that the status in Digital Card Data only supports the ACTIVE status.

Interface Changes

The following changes were made to the interface:

• Added a lastUsedCardTimestamp return parameter to the Identity Lookup JavaScript API.
• Deprecated the authenticationContext Checkout parameter. All Authentication Context fields are deprecated; use the equivalent fields in DPA Transaction Options instead.
• Added the following fields to DPA Transaction Options: authenticationPreferences, acquirerBIN, merchantName, recurringData, and acquirerMerchantId.
• Added authenticationPreferences and recurringData structures.
• Deprecated the following fields in DPA Transaction Options: transactionInstruction, numberOfPayments, purchaseDate, recurringEndDate, recurringFrequency, and authenticatedCredentialRequested.
• Added the 3DS enum value to the authenticationMethodType field in Authentication Method and deprecated the MANAGED_AUTHENTICATION enum.

Documentation Changes

The following changes were made to documentation:

• Changed the descriptive name of the identityLookup JavaScript API from "Identity Lookup Account by Consumer ID" to "Identity Lookup Using Consumer Identity."
• Updated description for transactionAmount in DPA Transaction Options.
• Updated examples for "Checkout input when new card is added – 3DS version" and "Checkout input when existing card is selected – 3DS version."

• Clarified that the mobileNumber field in the checkout() parameters is required when adding a new card.
• Changed the name of the mobileNumber field in the Masked Consumer structure to maskedMobileNumber and noted that it is not returned by the getSrcProfile() method.
• Added an optional encryptedBillingAddress field to the checkout() method's parameters.
• Added the IDENTITY_VALIDATION_REQUIRED error to the checkout() method.

Visa Click to Pay JavaScript Reference

Documentation Changes

The following changes were made to documentation:

• Added clarifications for Cardholder Authentication Methods (3DS, Passkey, and CVV2)
• Added clarifications for First Time User and Add Card scenarios for Visa

• Initial Release of Unified Click to Pay

Unified Click to Pay JavaScript Reference