taler-docs

commit c7dffa32e3bbaeccde89149e9f06528bc0fcbc83
parent 2a72ac5effc50d2ee5d0542ba0abff9be01288a9
Author: MS <ms@taler.net>
Date:   Tue, 31 Oct 2023 14:04:00 +0100

Nexus submit.

Updating the manpage and DD 50, after the implementation.

Diffstat:
M
design-documents/050-libeufin-nexus.rst
 | 
12
++++++++++++
M
manpages/libeufin-nexus.1.rst
 | 
17
+++++++++++++++++

2 files changed, 29 insertions(+), 0 deletions(-)
diff --git a/design-documents/050-libeufin-nexus.rst b/design-documents/050-libeufin-nexus.rst
@@ -298,3 +298,15 @@ Discussion / Q&A
   the bank response, may lead double-submission even if the HTTP talk ended
   well: it suffices to crash after having received a "200 OK" response but
   before setting the submitted flag to the database.
+
+* the ebics-submit section mentions the EBICS order ID.  The following excerpt
+  was found however at page 88 of the EBICS 3 specifications: 
+
+  ``OrderID is only present if a file is transmitted to the bank relating to an order with an
+  already existing order number (only allowed for AdminOrderType = HVE or HVS)``
+
+  Nexus does not support HVE or HVS.
+
+* As of private communication, the responsibility of submitting idempotent payments
+  relies on the use of ``request_uid`` (a database column of the initiated payment)
+  as the ``MsgId`` value of the corresponding pain.001 document.
diff --git a/manpages/libeufin-nexus.1.rst b/manpages/libeufin-nexus.1.rst
@@ -75,6 +75,23 @@ Its options are as follows:
 **-r** \| **--reset**
    If present, deletes any database table (WARNING: potential data loss)
 
+
+ebics-submit
+------------
+
+This subcommand submits any initiated payment, that was not already sent to the bank.  In the current version, initiated payments may come either from a cash-out operation or from a bounced incoming payment.  There is therefore **no** way to manually initiate a payment at this moment.  This tool is Taler friendly, therefore bounced payments are those that do not contain a valid subject to start a Taler withdrawal.  Cash-out operations come from a tightly integrated bank that offers their customers to convert their currency to the currency whose the EBICS subscriber bank account is tied to.
+
+
+Its options are as follows:
+
+**-h** \| **--help**
+   Print short help on options.
+**-c** \| **--config** \ ‌\ *FILENAME*
+   Specifies the configuration file.
+**--transient**
+   This flag, enabled by default, causes the command to run only once without any long-polling behaviour.
+   The configuration value `FREQUENCY` gets therefore ignored.
+
 Bugs
 ====