commit 7f413478844df1b7d1585767cea80b2c91b152ce
parent ebca23da9eb303d86a784ad3ecbf1dbce34ef461
Author: MS <ms@taler.net>
Date: Thu, 13 Jul 2023 09:23:49 +0200
EBICS 3 tutorial: rewording.
Diffstat:
1 file changed, 15 insertions(+), 15 deletions(-)
diff --git a/libeufin/ebics3-test-tutorial.rst b/libeufin/ebics3-test-tutorial.rst
@@ -18,15 +18,15 @@ Setting up the test platform at PostFinance
Because the test is based on the PostFinance test platform, the first
requirement is to create one account `there <https://isotest.postfinance.ch>`_.
-It's adivsed to set the language as English, as this tutorial is meant
+It is advised to set the language as English, as this tutorial is meant
for the international audience.
Set the language in the dropdown menu and navigate to the registration
-section as it's shown below:
+section as it is shown below:
.. image:: set-english-and-register.png
-Even if the page doesn't welcome you in English, the two boxes in the
+Even if the above 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.
@@ -36,7 +36,7 @@ page should appear. Click then on box #2.
.. note::
- The navigation bar in the following screenshot is ubiquitous,
+ The navigation bar in the screenshot below is ubiquitous,
so click on box #1 if the depicted page did not show up automatically.
.. image:: no-accounts.png
@@ -48,8 +48,8 @@ Swiss IBAN and enter it as indicated by box #1 and then save it (box #2).
.. image:: set-IBAN.png
-If the bank responds with a successful message, proceed by enabling
-EBICS 3 and setting the format of the ISO20022 documents.
+If the bank responds with a successful message, the next step is to enable
+EBICS 3 and set the format of the ISO20022 documents.
.. note::
@@ -157,7 +157,7 @@ via the traditional paper mail.
.. image:: set-EBICS-keys.png
After having confirmed the new keys, the execution can be resumed to
-let the test runner proceed with the uploading and downloading operations.
+for the uploading and downloading operations.
Upload
======
@@ -186,9 +186,9 @@ in this case, open the (archive) file whose timestamp corresponds to the
test execution and look for one XML file whose name contains "pain.001"
(likely, this XML file is named after the archive's name). If found,
the pain.001 file is expected to contain one node called ``Ustrd``: that
-is the payment subject and must match the one that was specified by the
-test runner. If they match, resume the test from its pause and
-proceed to the `Download`_ operation.
+is the payment subject and must match the one that was specified right
+before the upload. If they match, the upload succeeded and the execution
+can be resumed for the `Download`_ operation.
Download
========
@@ -200,18 +200,18 @@ in the pain.001 case, EBICS is responsible to transport the camt.054 from
the bank to the client.
The download operation logs its activity to the screen, and if the execution
-is correct, the user should check the logs for the payment subject that was
-initially specified in the pain.001 document.
+is correct, the payment subject that was initially specified in the pain.001
+document must appear.
Please, look for the following line:
-.. note::
- Replace $TIME, $PAYMENT_SUBJECT and $MSG_ID with the particular case.
-
.. code-block:: shell-session
$TIME [main] DEBUG tech.libeufin.nexus - Camt NOTIFICATION '$MSG_ID' has new payments:
- $PAYMENT_SUBJECT
+.. note::
+ Replace $TIME, $PAYMENT_SUBJECT and $MSG_ID with the particular case.
+
If $PAYMENT_SUBJECT equals the initial payment subject from the pain.001,
then the download operation succeeded.
