commit a8598e75979d1b7746d95f35b613a6b2d352ec6d
parent 554f0f89ae0f421d1deff7a75715de2b25a2435f
Author: Antoine A <>
Date: Fri, 1 Aug 2025 16:41:23 +0200
nexus: add manual acknowledgement
Diffstat:
3 files changed, 99 insertions(+), 2 deletions(-)
diff --git a/libeufin/nexus-manual.rst b/libeufin/nexus-manual.rst
@@ -330,6 +330,28 @@ can be ignored. This imply that the actual balance of your bank account may devi
To fix this, you must periodically send administrative balance adjustment
transfers conaining "ADMIN BALANCE ADJUST" in their subject.
+Manual submission acknowledgement
+=================================
+
+By default LibEuFin Nexus automatically start submitting all initiated payments. You can enforce manual submission acknowledgement by changing your config:
+
+.. code-block:: ini
+
+ [nexus-submit]
+ MANUAL_ACK = YES
+
+To list pending transactions run:
+
+.. code-block:: console
+
+ $ libeufin-nexus list initiated -c "$CONFIG_FILE" --awaiting-ack
+
+To enable the submission of some transactions run:
+
+.. code-block:: console
+
+ $ libeufin-nexus manual ack -c "$CONFIG_FILE" $IDS
+
Manual EBICS import & export
============================
diff --git a/manpages/libeufin-nexus.1.rst b/manpages/libeufin-nexus.1.rst
@@ -18,7 +18,7 @@ Synopsis
COMMAND [ARGS...]
Subcommands: **dbinit**, **ebics-setup**, **ebics-submit**, **ebics-fetch**,
-**serve**, **initiate-payment**, **manual**, **config**
+**serve**, **initiate-payment**, **manual**, **list**, **config**
Description
@@ -181,7 +181,7 @@ Its options are as follows:
**-h** \| **--help**
Print short help on options.
-Subcommands: **export**, **import**, **status**
+Subcommands: **export**, **import**, **status**, **ack**
manual export
^^^^^^^^^^^^^
@@ -231,6 +231,78 @@ Its options are as follows:
**-h** \| **--help**
Print short help on options.
+manual ack
+^^^^^^^^^^
+
+Manually acknowledge the outgoing transaction for submission.
+
+It takes many transactions as arguments.
+
+Its options are as follows:
+
+**-c** \| **--config** *config_file*
+ Specifies the configuration file.
+**-L** \| **--log** *LOGLEVEL*
+ Configure logging to use LOGLEVEL.
+**-h** \| **--help**
+ Print short help on options.
+
+list
+----
+
+List nexus transactions.
+
+Its options are as follows:
+
+**-h** \| **--help**
+ Print short help on options.
+
+Subcommands: **incoming**, **outgoing**, **initiated**
+
+list incoming
+^^^^^^^^^^^^^
+
+List incoming transactions.
+
+Its options are as follows:
+
+**-c** \| **--config** *config_file*
+ Specifies the configuration file.
+**-L** \| **--log** *LOGLEVEL*
+ Configure logging to use LOGLEVEL.
+**-h** \| **--help**
+ Print short help on options.
+
+list outgoing
+^^^^^^^^^^^^^
+
+List outgoing transactions.
+
+Its options are as follows:
+
+**-c** \| **--config** *config_file*
+ Specifies the configuration file.
+**-L** \| **--log** *LOGLEVEL*
+ Configure logging to use LOGLEVEL.
+**-h** \| **--help**
+ Print short help on options.
+
+list initiated
+^^^^^^^^^^^^^^
+
+List initiated transactions.
+
+Its options are as follows:
+
+**-c** \| **--config** *config_file*
+ Specifies the configuration file.
+**-L** \| **--log** *LOGLEVEL*
+ Configure logging to use LOGLEVEL.
+**--ack** \| **--awaiting-ack**
+ Only list transactions awaiting manual acknowledgement.
+**-h** \| **--help**
+ Print short help on options.
+
.. include:: ../frags/libeufin-config-cli.rst
SEE ALSO
diff --git a/manpages/libeufin-nexus.conf.5.rst b/manpages/libeufin-nexus.conf.5.rst
@@ -89,6 +89,9 @@ FREQUENCY
Duration value to instruct the ``ebics-submit`` subcommand how much to wait
before checking the database again to find new unsubmitted payments.
+MANUAL_ACK
+ Wether to wait for manual acknowledgement before submiting transactions.
+
EBICS FETCH OPTIONS
-------------------
