commit 2708ebc7e9dc56817fc1b4b44b2c0eeae6c078e9
parent b24472b8c0b970d5a7e8f83d947f94d887e86b2f
Author: Antoine A <>
Date: Tue, 27 May 2025 17:48:37 +0200
libeufin-nexus: update conf and manual
Diffstat:
2 files changed, 35 insertions(+), 0 deletions(-)
diff --git a/libeufin/nexus-manual.rst b/libeufin/nexus-manual.rst
@@ -272,6 +272,32 @@ will download at the frequency specified in the configuration or when it receive
The ``--debug-ebics $SAVEDIR`` flag will cause EBICS transactions steps and payloads to be stored in ``$SAVEDIR/$YYYY-MM-DD`` where ``$YYYY-MM-DD`` represents the date when the download took place. This is mostly useful for debugging.
+Bounce fee
+----------
+
+When a transaction is malformed, she is bounced back, the amount received is transferred back to the sender.
+First time users often make mistakes when sending a transaction manually, so you can expect frequent bounces. It's important that this process is user-friendly, which is why bounces are automatic.
+
+However, bounces can be costly if your bank charges you transfer fees. Here are a few parameters you can adjust to get around this problem, but bear in mind that it's often better for business to bear this cost:
+
+.. code-block:: ini
+
+ [nexus-fetch]
+ # LibEuFin Nexus can automatically deduce the transfer fees if they appears inside camt files
+ BOUNCE_DEDUCE_FEE = YES
+ # Or/and you can apply a fixed bounce fee
+ BOUNCE_FEE = CURRENCY:0.1
+
+Account restriction
+-------------------
+
+If you configured an exchange with ``credit_restrictions``, you should configure LibEuFin Nexus to bounce transactions coming from restricted accounts automatically:
+
+.. code-block:: ini
+
+ [nexus-fetch]
+ # Use the same regex used during exchange configuration
+ RESTRICTION_PAYTO_REGEX = payto://iban/CH.*
For Testing
-----------
diff --git a/manpages/libeufin-nexus.conf.5.rst b/manpages/libeufin-nexus.conf.5.rst
@@ -96,6 +96,15 @@ IGNORE_TRANSACTIONS_BEFORE
IGNORE_BOUNCES_BEFORE
Ignore all malformed transactions prior to a certain YYYY-MM-DD date, useful when you want to import old transactions without bouncing the malformed ones a second time.
+BOUNCE_DEDUCE_FEE
+ Wether to deduce the fee payed by the exchange account from the bounced amount
+
+BOUNCE_FEE
+ An additional fee to deduce from the bounced amount
+
+RESTRICTION_PAYTO_REGEX
+ Bounce transactions coming from account not matching this regex
+
HTTP SERVER OPTIONS
-------------------
