[taler-docs] branch master updated: Nexus submit.

[gnunet]

This is an automated email from the git hooks/post-receive script.

ms pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new c7dffa32 Nexus submit.
c7dffa32 is described below

commit c7dffa32e3bbaeccde89149e9f06528bc0fcbc83
Author: MS <ms@taler.net>
AuthorDate: Tue Oct 31 14:04:00 2023 +0100

    Nexus submit.
    
    Updating the manpage and DD 50, after the implementation.
---
 design-documents/050-libeufin-nexus.rst | 12 ++++++++++++
 manpages/libeufin-nexus.1.rst           | 17 +++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/design-documents/050-libeufin-nexus.rst 
b/design-documents/050-libeufin-nexus.rst
index 62d1602f..1d563936 100644
--- 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
index 253f1b38..8fb41ed5 100644
--- 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 [...]
+
+
+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
 ====
 

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.