commit 8f7c57edee92c4586a51acb3aa5f8854cd53b62f
parent 7aeaa8290eaa71994675e478e3c73053d6f33ab4
Author: MS <ms@taler.net>
Date: Mon, 10 Jul 2023 13:02:52 +0200
EBICS 3 tutorial.
First version of the text with the screenshots.
Diffstat:
8 files changed, 36 insertions(+), 13 deletions(-)
diff --git a/libeufin/camt.054-style-0.png b/libeufin/camt.054-style-0.png
Binary files differ.
diff --git a/libeufin/camt.054-style-1.png b/libeufin/camt.054-style-1.png
Binary files differ.
diff --git a/libeufin/ebics3-test-tutorial.rst b/libeufin/ebics3-test-tutorial.rst
@@ -23,36 +23,59 @@ section as it's shown below:
.. image:: set-english-and-register.png
+Even if the page doesn't welcome you in English, the two boxes in the
+screenshot will still hold their position, so please look for box #1 to
+set the language and for box #2 to get the page that offers to register.
+
After a sucessful registration, the next two settings need to be given:
(1) EBICS 3 and (2) the format of payment confirmations (more on this later).
Note: setting EBICS 3 is not *explicit*, but it's a side effect of choosing
one particular format for downloading the bank account records. The following
-screenshot shows how:
+screenshots show how. First, from the profile home page, click the navigation
+bar item highlighted in the following screenshot.
+
+.. image:: set-ISO-2019-0.png
+
+
+The following page should appear, where the ISO format can be specified
+as it is depicted in the following screenshot.
-.. image:: set-ISO20022-2019.png
+.. image:: set-ISO-2019-1.png
Payment confirmations are ISO20022 documents that witness the outcome
of outgoing payments. After sending 1 Swiss Franc to one arbitrary IBAN,
-the bank releases this document that contains all the payment details. In
-this test, we use this document to test the download capability of our EBICS
-3 implementation. The specific name of such documents is ``camt.054``, and
-the following screenshot shows how to set them:
+the bank releases this document that contains all the payment details.
+In this test, we use this document to test the download capability of
+our EBICS 3 implementation. The specific name of such documents is
+``camt.054``, and the following screenshots show how to set them. From
+the profile home page, hover on box #1 and then click on box #2.
-.. image:: set-camt.054.png
+.. image:: camt.054-style-0.png
+If the following page appear, please set everything as it is shown below:
+
+.. image:: camt.054-style-1.png
.. _get-ebics-ids:
The last step is to retrieve the user's EBICS identifiers, namely the
-EBICS user and partner IDs. Please find them how it is shown below:
+EBICS user and partner IDs. From the profile home page, hover on box #1
+and then click on box #2.
+
+.. image:: get-EBICS-IDs-0.png
+
+After having navigated to the following page, finally the EBICS identifiers
+are shown in box #1. These values will be asked to launch the test runner.
+**Note**: the terms 'customer' and 'partner' are used as **synonyms** in this
+tutorial (and in the EBICS specifications too).
-.. image:: get-ebics-ids.png
+.. image:: get-EBICS-IDs-1.png
-Interestingly, the same page above contains also the bank keys fingerprints
-(right bottom corner). These are important to check that the client, along
-the keying process, has obtained the right bank keys. The interactive test
-will give the desired time to the user to check them.
+Interestingly, box #2 contains the bank keys fingerprints. These are
+important to check that the client, along the keying process, has obtained
+the right bank keys. The test runner will pause the execution to let
+the user check them.
Setting up the local Docker
---------------------------
diff --git a/libeufin/get-EBICS-IDs-0.png b/libeufin/get-EBICS-IDs-0.png
Binary files differ.
diff --git a/libeufin/get-EBICS-IDs-1.png b/libeufin/get-EBICS-IDs-1.png
Binary files differ.
diff --git a/libeufin/set-ISO-2019-0.png b/libeufin/set-ISO-2019-0.png
Binary files differ.
diff --git a/libeufin/set-ISO-2019-1.png b/libeufin/set-ISO-2019-1.png
Binary files differ.
diff --git a/libeufin/set-english-and-register.png b/libeufin/set-english-and-register.png
Binary files differ.
