Skip to content

Update 3DS v2.2 to v2.3.1 diff #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thejspr merged 1 commit into from
May 12, 2026
Merged

Update 3DS v2.2 to v2.3.1 diff #39

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 66 additions & 12 deletions source/differences_v220_v231.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,16 @@ This document outlines the differences in message fields between 3D-Secure speci
Summary of Changes
------------------

+--------------+--------------+----------------+------------------------+
| Message Type | Fields Added | Fields Removed | Fields Renamed/Changed |
+==============+==============+================+========================+
| AReq | 25 | 1 | 2 |
+--------------+--------------+----------------+------------------------+
| ARes | 11 | 0 | 3 |
+--------------+--------------+----------------+------------------------+
| RReq | 5 | 0 | 3 |
+--------------+--------------+----------------+------------------------+
+--------------+--------------+----------------+------------------------+-------------------------------+
| Message Type | Fields Added | Fields Removed | Fields Renamed/Changed | Fields with Type/Cardinality |
| | | | | Change |
+==============+==============+================+========================+===============================+
| AReq | 29 | 1 | 2 | 3 |
+--------------+--------------+----------------+------------------------+-------------------------------+
| ARes | 11 | 0 | 3 | 2 |
+--------------+--------------+----------------+------------------------+-------------------------------+
| RReq | 5 | 0 | 3 | 1 |
+--------------+--------------+----------------+------------------------+-------------------------------+

AReq Changes
-------------------------------------
Expand All @@ -41,6 +42,10 @@ New Fields Added in v2.3.1
- Unstructured information sent between 3DS Server, DS and ACS
* - **cardSecurityCode**
- Three- or four-digit security code printed on the card
* - **cardSecurityCodeStatus**
- Communication of Card Security Code Status
* - **cardSecurityCodeStatusSource**
- System setting Card Security Code Status
* - **deviceBindingStatus**
- Communication of Device Binding Status between ACS, DS and 3DS Requestor
* - **deviceBindingStatusSource**
Expand All @@ -51,7 +56,7 @@ New Fields Added in v2.3.1
- Characteristics of a Default-SDK
* - **multiTransaction**
- Additional transaction information for multiple transactions or Merchants
* - **payeeOriginAReq**
* - **payeeOrigin**
- Origin of the payee for SPC Transaction Data
* - **payTokenInfo**
- Information about detokenised Payment Token
Expand All @@ -67,8 +72,6 @@ New Fields Added in v2.3.1
- Indicates whether recurring/instalment payment has fixed or variable amount and frequency
* - **sdkServerSignedContent**
- JWS object created by the Split-SDK Server for AReq message
* - **sdkSignatureTimestamp**
- Date and time when 3DS SDK generated the Split-SDK Server Signed Content
* - **sdkType**
- Indicates the type of 3DS SDK
* - **sellerInfo**
Expand Down Expand Up @@ -112,6 +115,26 @@ Fields Renamed/Changed in v2.3.1
* - **whiteListStatusSource** → **trustListStatusSource**
- System setting Trust List Status

Fields with Changed Type/Cardinality in v2.3.1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
:header-rows: 1
:widths: 40 30 30

* - Field Name
- v2.2.0 Type
- v2.3.1 Type
* - **threeDSRequestorChallengeInd**
- Single string
- Array of strings
* - **threeDSRequestorAuthenticationInfo**
- Single object
- Array of objects
* - **threeDSRequestorPriorAuthenticationInfo**
- Single object
- Array of objects

----

ARes Changes
Expand Down Expand Up @@ -166,6 +189,23 @@ Fields Renamed/Changed in v2.3.1
* - **whiteListStatusSource** → **trustListStatusSource**
- System setting Trust List Status

Fields with Changed Type/Cardinality in v2.3.1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
:header-rows: 1
:widths: 40 30 30

* - Field Name
- v2.2.0 Type
- v2.3.1 Type
* - **cardholderInfo**
- String (max 128 chars)
- Object ``{text, issuerImage, paymentSystemImage}``
* - **acsRenderingType**
- Object ``{acsInterface, acsUiTemplate}``
- Object ``{acsInterface, acsUiTemplate, deviceUserInterfaceMode}``

----

RReq Changes
Expand Down Expand Up @@ -207,6 +247,20 @@ Fields Renamed/Changed in v2.3.1
* - **whiteListStatusSource** → **trustListStatusSource**
- System setting Trust List Status

Fields with Changed Type/Cardinality in v2.3.1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
:header-rows: 1
:widths: 40 30 30

* - Field Name
- v2.2.0 Type
- v2.3.1 Type
* - **acsRenderingType**
- Object ``{acsInterface, acsUiTemplate}``
- Object ``{acsInterface, acsUiTemplate, deviceUserInterfaceMode}``

----

*This document reflects the field-level differences between 3D-Secure specification versions 2.2.0 and 2.3.1. For complete implementation details, refer to the official EMVCo 3D-Secure specification documents.*
Loading