Skip to content

V2.3.1 docs update #27

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
Lassejoe merged 67 commits into from
Jul 7, 2025
Merged

V2.3.1 docs update #27

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
67 commits
Select commit Hold shift + click to select a range
ce1529f
Fix dev build script
thejspr May 23, 2024
a94aae7
Add v2.3.1.1 docs
thejspr May 23, 2024
e0aa54c
Fix link to spec
thejspr May 23, 2024
76c8d27
Update year
thejspr May 23, 2024
a03481d
Add 2.3.1.1 sources
thejspr May 23, 2024
2b908d1
Update references
thejspr May 23, 2024
222c446
Update getting started
thejspr May 23, 2024
cf3250f
Update versioning
thejspr May 23, 2024
18b5038
Update server information
thejspr May 23, 2024
572b904
Update usage
thejspr May 23, 2024
59620ef
Update guides
thejspr May 23, 2024
3fce7fa
Update challenge flow
thejspr May 23, 2024
1e7dc76
Update existing static sources. Mostly formatting and indentation
thejspr May 23, 2024
0003644
fix 231 references
thejspr May 23, 2024
eb346d4
update sandbox
thejspr May 23, 2024
cd5f749
fix references and add to changelog
thejspr May 23, 2024
d7605d1
fix challenge flow reference
thejspr May 23, 2024
a823178
update readme
thejspr May 23, 2024
cbeefab
use latest sphinx-docs
thejspr May 23, 2024
9c911c2
Add formatting docs
thejspr May 29, 2024
058b2d6
prettify css
thejspr May 29, 2024
90527d0
Prettier scenario selector
thejspr May 29, 2024
127816b
prettier html
thejspr May 29, 2024
05c02d4
prettier docs
thejspr May 29, 2024
5dc0e93
Merge branch 'prettier-docs' into v2.3.1-docs-update
thejspr May 29, 2024
03cf460
sameline brackets
thejspr May 29, 2024
ebaecf7
Merge branch 'prettier-docs' into v2.3.1-docs-update
thejspr May 29, 2024
6caa7f5
fixup acctinfo
thejspr May 29, 2024
aa553d7
fixup acsrenderingtype
thejspr May 29, 2024
2d7df16
Merge branch 'master' into v2.3.1-docs-update
thejspr May 29, 2024
88e5b9b
remove empty attributeName noise
thejspr May 29, 2024
37548d6
remove more noise
thejspr May 29, 2024
b8f12dc
Fix selector
thejspr May 30, 2024
1b5093a
dont change crd spec for 220 and 210
thejspr May 30, 2024
a97d57c
231 specific threedsrequestorpriorauthenticationinfo
thejspr May 30, 2024
86c65c7
Update source/versioning.rst
thejspr May 31, 2024
134603c
Remove fime from preauth values
thejspr May 31, 2024
b9bb241
sandbox min version
thejspr May 31, 2024
d9e16ab
Update source/guides.rst
thejspr May 31, 2024
932c40a
update sandbox message version
thejspr Jun 3, 2024
d166d6e
Merge branch 'master' into v2.3.1-docs-update
thejspr Jun 3, 2024
a2a733c
make some attributes clickable
thejspr Jun 3, 2024
bc350c3
Update source/reference.rst
thejspr Jun 3, 2024
805cb70
fix naming in areq
thejspr Jun 3, 2024
3594600
Update 2.3.1 specs
thejspr Jun 3, 2024
75614df
Add preauth max message version
thejspr Jul 16, 2024
f5f54dc
Update docs
thejspr Aug 13, 2024
1a5c342
Merge branch 'master' into v2.3.1-docs-update
thejspr Aug 28, 2024
e989e7d
remove spec files
thejspr Aug 28, 2024
42f9d3f
Merge branch 'master' into v2.3.1-docs-update
thejspr Sep 18, 2024
20682b3
rename 2.3.1.1 to 2.3.1
thejspr Sep 19, 2024
115c56c
Update docs
thejspr Oct 11, 2024
06a96f7
Merge branch 'master' into v2.3.1-docs-update
thejspr Oct 14, 2024
c4c8713
Cleanup linter fixes
thejspr Oct 16, 2024
037e6cb
Fix merge conflict in changelog.rst
thejspr Oct 16, 2024
1a83bcf
revert some linter changes
thejspr Oct 16, 2024
4cbe55e
remove empty attributeName noise
thejspr Oct 16, 2024
64897d5
Update source/_static/creq.html
thejspr Oct 16, 2024
0940081
Add two new Nested objects to v2.3.1
Jun 18, 2025
50670bb
Point to the new nested objects
Jun 18, 2025
605d9ab
Update link to countryCode
Jun 18, 2025
32aa640
Formatting html and css files with prettier command
Jun 18, 2025
c70bb77
Add missing link for v2.3.1 version in postauth
Jun 18, 2025
109b63c
Update links, requirements and description fields
Jun 18, 2025
d945a38
Update content
Jun 26, 2025
743ccf5
Update fields in ARes and AReq
Jul 4, 2025
704c3bc
Update change log
Jul 7, 2025
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
2 changes: 1 addition & 1 deletion .github/workflows/deploy.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ jobs:
run: |
mkdir build
chmod 777 build
docker run --rm -v $PWD:/opt -w /opt -e USER_ID=$UID ddidier/sphinx-doc:2.2.1-1 sphinx-build -b html source build
docker run --rm -v $PWD:/opt -w /opt -e USER_ID=$UID ddidier/sphinx-doc:7.1.2-1 sphinx-build -b html source build

- name: Install AWS Cli
run: pip install awscli
Expand Down
8 changes: 4 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,18 +21,18 @@ Comments, pull requests and general feedback is welcome from anyone.

The 3-D Secure v2 specification is defined by EMVCo, their list of 3-D Secure v2
documentation can be found [on their documentation
page](https://www.emvco.com/document-search/?action=search_documents&publish_date=&emvco_document_version=&emvco_document_book=&px_search=&emvco_document_technology%5B%5D=3-d-secure).
page](https://www.emvco.com/specifications/?tax%5Bspecifications_categories%5D%5B32%5D%5B%5D=84&tax%5Bspecifications_categories%5D%5B33%5D%5B%5D=447).

Specifically, the primary documentation can be found in [EMV® 3-D Secure
Protocol and Core Functions Specification.](https://www.emvco.com/wp-content/uploads/documents/EMVCo_3DS_Spec_v220_122018.pdf)
Specifically, the primary documentation can be found in named "EMV® 3-D Secure
Protocol and Core Functions Specification".

The spec is currently at version 2.2.0.

## Generate documentation locally

The documentation is currently generated by Sphinx. It can be generated locally with:

docker run --rm -v $PWD:/opt -w /opt -e USER_ID=$UID ddidier/sphinx-doc:4.1.2-2 sphinx-build -b html source build
docker run --rm -v $PWD:/opt -w /opt -e USER_ID=$UID ddidier/sphinx-doc:7.1.2-1 sphinx-build -b html source build

The generated documentation is then rooted in `build/index.html`.

Expand Down
2 changes: 1 addition & 1 deletion source/3dsmethod.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ If `3DS Method URL`_ is included in the :ref:`preauth-usage` response, the
3DS method *must* be invoked as explained in this guide.

If ``threeDSMethodURL`` *is not* included in the ``/preauth`` response (ref.
:ref:`2.1.0 <preauth-response-210>`, :ref:`2.1.0 <preauth-response-220>`),
:ref:`2.1.0 <preauth-response-210>`, :ref:`2.2.0 <preauth-response-220>`, :ref:`2.3.1 <preauth-response-231>`),
continue with the :ref:`auth-usage` and set `3DS Completion indicator
<specification_210.html#attr-AReq-threeDSCompInd>`_ to ``"U"``, to indicate that the
3DS Method was not available.
Expand Down
70 changes: 51 additions & 19 deletions source/_static/acctinfo.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -342,6 +342,38 @@
categories=""
channels=""
class="row-even attribute-header"
id="attr-AcctInfo-chAccReqID">
<div class="attribute-name">
chAccReqID<a
class="link"
href="#attr-AcctInfo-chAccReqID"
title="Permalink to this attribute"></a>
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-even attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
<div class="requirements">
<div class="maxLength">
Max length:
<code><span class="pre">64</span></code>
</div>
</div>
</div>
<div class="argdesc">
<div class="description">
The 3DS Requestor assigned account identifier of the transacting
Cardholder.
</div>
</div>
</div>
</div>
<div
categories=""
channels=""
class="row-odd attribute-header"
id="attr-AcctInfo-nbPurchaseAccount">
<div class="attribute-name">
nbPurchaseAccount<a
Expand All @@ -351,7 +383,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-even attribute-details">
<div categories="" channels="" class="row-odd attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down Expand Up @@ -382,7 +414,7 @@
<div
categories=""
channels=""
class="row-odd attribute-header"
class="row-even attribute-header"
id="attr-AcctInfo-paymentAccAge">
<div class="attribute-name">
paymentAccAge<a
Expand All @@ -392,7 +424,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-odd attribute-details">
<div categories="" channels="" class="row-even attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down Expand Up @@ -421,7 +453,7 @@
<div
categories=""
channels=""
class="row-even attribute-header"
class="row-odd attribute-header"
id="attr-AcctInfo-paymentAccInd">
<div class="attribute-name">
paymentAccInd<a
Expand All @@ -431,7 +463,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-even attribute-details">
<div categories="" channels="" class="row-odd attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down Expand Up @@ -497,7 +529,7 @@
<div
categories=""
channels=""
class="row-odd attribute-header"
class="row-even attribute-header"
id="attr-AcctInfo-provisionAttemptsDay">
<div class="attribute-name">
provisionAttemptsDay<a
Expand All @@ -507,7 +539,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-odd attribute-details">
<div categories="" channels="" class="row-even attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down Expand Up @@ -537,7 +569,7 @@
<div
categories=""
channels=""
class="row-even attribute-header"
class="row-odd attribute-header"
id="attr-AcctInfo-shipAddressUsage">
<div class="attribute-name">
shipAddressUsage<a
Expand All @@ -547,7 +579,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-even attribute-details">
<div categories="" channels="" class="row-odd attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand All @@ -571,7 +603,7 @@
<div
categories=""
channels=""
class="row-odd attribute-header"
class="row-even attribute-header"
id="attr-AcctInfo-shipAddressUsageInd">
<div class="attribute-name">
shipAddressUsageInd<a
Expand All @@ -581,7 +613,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-odd attribute-details">
<div categories="" channels="" class="row-even attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down Expand Up @@ -640,7 +672,7 @@
<div
categories=""
channels=""
class="row-even attribute-header"
class="row-odd attribute-header"
id="attr-AcctInfo-shipNameIndicator">
<div class="attribute-name">
shipNameIndicator<a
Expand All @@ -650,7 +682,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-even attribute-details">
<div categories="" channels="" class="row-odd attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down Expand Up @@ -695,7 +727,7 @@
<div
categories=""
channels=""
class="row-odd attribute-header"
class="row-even attribute-header"
id="attr-AcctInfo-suspiciousAccActivity">
<div class="attribute-name">
suspiciousAccActivity<a
Expand All @@ -705,7 +737,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-odd attribute-details">
<div categories="" channels="" class="row-even attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down Expand Up @@ -750,7 +782,7 @@
<div
categories=""
channels=""
class="row-even attribute-header"
class="row-odd attribute-header"
id="attr-AcctInfo-txnActivityDay">
<div class="attribute-name">
txnActivityDay<a
Expand All @@ -760,7 +792,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-even attribute-details">
<div categories="" channels="" class="row-odd attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down Expand Up @@ -792,7 +824,7 @@
<div
categories=""
channels=""
class="row-odd attribute-header"
class="row-even attribute-header"
id="attr-AcctInfo-txnActivityYear">
<div class="attribute-name">
txnActivityYear<a
Expand All @@ -802,7 +834,7 @@
</div>
<div class="attribute-type">string</div>
</div>
<div categories="" channels="" class="row-odd attribute-details">
<div categories="" channels="" class="row-even attribute-details">
<div class="arg">
<div class="argdef">
<div class="inclusion">Optional</div>
Expand Down
Loading