What's new in version 2.2.20230227?
Supporting EMV 3DSv 2.2.0
Supporting EMV 3DSv2.2.0 is highly encouraged. Visa and Mastercard have announced that 2.1.0 will be deprecated in 2024. PAAY is planning to stop maintaining 2.1.0 versions starting June 2023.
Supporting EMV 3DSv2.2.0 is a minor update. It is highly encouraged to refer to previous versions to see what has changed that can cause breaking changes.
This new version prioritizes authenticating with 2.2.0 when the issuers support it.
Bug:
Data Only: At this moment there is an issue in passing
challengeIndicator
06. The settings to allow it to pass is to make setshowChallenge
to true. Setting it to true will not show the iframe since this is a frictionless transaction that is being requested.showChallenge
only displays if the ACS/Issuer challenges the transaction. When the fix is made, a new version of the JS SDK will be published. Date TBD.
- Strong Customer Authentication (SCA) (e.g., Delegated Authentication)
- Transactional Risk Analysis (TRA)
- White list
PAAY allows the additional fields to be passed to the issuer to request an exemption. This data enables the issuer to accept an exemption and provide a more optimized customer experience. To learn more about PSD2, please follow this link.
- Data Share Only
A process for merchants and issuers to exchange data without a cardholder challenge to assist in better authorization approvals. Liability is not shifted on these transactions.
New API endpoints for both sandbox and live environments have been created and must be explicitly used in order to authenticate on 3DS 2.2.0 if using the API integration.
Authorize:
https://api.3dsintegrator.com/v2.2/authorize
Authenticate:
https://api.3dsintegrator.com/v2.2/authenticate/browser
Fingerprinting:
{{methodURL}}/v2.2/fingerprint
{{responseUrl}}/v2.2/fingerprint/{{transactionId}}
Transactions Update:
https://api.3dsintegrator.com/v2.2/transaction/{transactionId}/updates
https://cdn.3dsintegrator.com/threeds.2.2.20230227.min.js
5. Continued use of PAAYs 3DS EMV 2.1.0 solution
PAAY will continue to support & maintain EMV 3DS 2.1.0 until July 2023 to help ease the transition. All new fixes and features will be released to the new JS SDK version. To continue PAAYS 2.1.0 3DS, endpoint in options must be set to v2 as per below example.
Sandbox:
<script>
var tds = new ThreeDS(
"<insert-form-id-here>",
"<insert-your-API-Key>",
null,
{
endpoint:"https://api-sandbox.3dsintegrator.com/v2", //sandbox environment
});
</script>
Live:
<script>
var tds = new ThreeDS(
"<insert-form-id-here>",
"<insert-your-API-Key>",
null,
{
endpoint:"https://api.3dsintegrator.com/v2", //live environment
});
</script>
What does this mean?
- 3DS will only authenticate with 2.1.0. No 2.2.0 logic will ever be applied.
- The new data element values of "05"-"09" for
challengeIndicator
will not be allowed to be passed. - Any new feature or bug releases will continue to be released in the new JS SDK while providing you the access to PAAYs 3DS 2.1 solution.
Deprecation of addResultToForm
In preparation for sunsetting the JS SDK option of addResultToForm
, it will now be set to false by default, and new response values returned from 2.2.0 will not be supported by this option. We require that merchants utilize the resolve method to obtain 3DS response data.
Updated 7 months ago