Update preauth response documentation (#34)

Due to clearhaus/issues-pci#5039 we should update the preauth documentation. The preauth response includes new additional fields.
clearhaus · Sep 17, 2024 · f41d8ef · f41d8ef
1 parent d053a62
commit f41d8ef
Show file tree

Hide file tree

Showing 2 changed files with 57 additions and 10 deletions.
diff --git a/source/changelog.rst b/source/changelog.rst
@@ -11,6 +11,13 @@ Select changes are added here.
 
 Pull requests and issues are welcome.
 
+September 17th, 2024
+*********************
+Updated preauth response to include two new fields:
+- ``acsProtocolVersions``: Array of objects containing the list of Protocol versions supported by the ACS for the card range,
+  with their associated ACS information indicator, the 3DS method URL, and the list of supported message extensions.
+- ``dsProtocolVersions``: Contains the list of active protocol versions supported by the DS.
+
 November 11th, 2020
 *******************
 

diff --git a/source/preauth.rst b/source/preauth.rst
@@ -80,16 +80,56 @@ If the card number is enrolled for 3-D Secure v2, the response might look
 something like:
 
 .. code-block:: json
-  :linenos:
-
-    {
-      "acsStartProtocolVersion": "2.1.0",
-      "acsEndProtocolVersion": "2.2.0",
-      "dsStartProtocolVersion": "2.1.0",
-      "dsEndProtocolVersion": "2.2.0",
-      "threeDSServerTransID": "d461f105-1792-407f-95ff-9a496fd918a9",
-      "threeDSMethodURL": "https://acs.tld/3dsmethod"
-    }
+   :linenos:
+
+   {
+     "acsStartProtocolVersion": "2.1.0",
+     "acsEndProtocolVersion": "2.2.0",
+     "dsStartProtocolVersion": "2.1.0",
+     "dsEndProtocolVersion": "2.2.0",
+     "dsProtocolVersions": [
+       "2.1.0",
+       "2.2.0"
+     ],
+     "acsProtocolVersions": [
+       {
+         "acsInfoInd": [
+           "01",
+           "02",
+           "84",
+           "85",
+           "86",
+           "87",
+           "88",
+           "89",
+           "92",
+           "93",
+           "94"
+         ],
+         "threeDSMethodURL": "https://acs.tld/3dsmethod",
+         "version": "2.1.0"
+       },
+       {
+         "acsInfoInd": [
+           "01",
+           "02",
+           "84",
+           "85",
+           "86",
+           "87",
+           "88",
+           "89",
+           "92",
+           "93",
+           "94"
+         ],
+         "threeDSMethodURL": "https://acs.tld/3dsmethod",
+         "version": "2.2.0"
+       }
+     ],
+     "threeDSServerTransID": "d461f105-1792-407f-95ff-9a496fd918a9",
+     "threeDSMethodURL": "https://acs.tld/3dsmethod"
+   }
 
 .. note::