taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

commit 6ede39e26b261695a1f70d5eb150e20fa5c58cab
parent bb4bdaa70935e56ba90fa2485e5b3bcc2f955ba1
Author: MS <ms@taler.net>
Date:   Thu, 14 Dec 2023 16:43:49 +0100

Regional manual.

Enabling and rewording wallet section - includes NLnet feedback

Diffstat:
Mlibeufin/regional-manual.rst | 50++++++++++++++++++++++++++------------------------
1 file changed, 26 insertions(+), 24 deletions(-)

diff --git a/libeufin/regional-manual.rst b/libeufin/regional-manual.rst @@ -253,6 +253,32 @@ If so, call the wallet in the following way to finally pay for the order just cr asks records to the bank. In particular, delete: any database and the files ``config/user.conf`` and ``config/internal.conf``, and finally run ``./main.sh`` again. + + +Wallet setup +============ + +This section describes the interaction between the Taler graphical wallet (Android, +iOS, WebExtensions) and the regional currency system. + +You need to add your regional currency exchange to the wallet. This can +be done by scanning a QR code with a ``taler://withdraw-exchange/exchange.$DOMAIN`` +URL or by manually entering the URL into the respective ``Add exchange`` +dialogue. + +After starting the withdraw process and specifying the desired amount, the wallet +should show you the details of the fiat wire transfer that must be made for the cash +in to be completed. Once the money has arrived at the fiat bank account, Nexus will +obtain the transaction data and the regional currency bank will create the +corresponding amount in regional currency, crediting the GNU Taler exchange account. +In turn, the exchange will issue the respective amount to your wallet. + +For testing, you should be able to *deposit* regional currency directly +into your LibEuFin Bank account from the Taler wallet. Note: the wallet relies on the +exchange to perform such deposit. So once the exchange has credited the regional +currency account to your account and assuming the cash out rules are satisfied, you +should then be able to start a cash out operation. + .. FIXME: uncomment once tested. @@ -329,7 +355,6 @@ If so, call the wallet in the following way to finally pay for the order just cr # systemd enable --now libeufin-nexus-ebics-fetch # systemd enable --now libeufin-nexus-ebics-submit - Going live! =========== @@ -359,26 +384,3 @@ If so, call the wallet in the following way to finally pay for the order just cr Here, the ``$CONVERSION_URL`` must be set to the base URL of the conversion endpoint of the bank, which should be ``https://bank.$DOMAIN/conversion-info/`` in our setup. - - Wallet setup - ------------ - - You need to add your regional currency exchange to the wallet. This can - be done by scanning a QR code with a ``taler://withdraw-exchange/exchange.$DOMAIN`` - URL or by manually entering the URL into the respective ``Add exchange`` - dialogue. - - With this, you should then be able to ``add`` funds in the regional currency - to your exchange by starting the withdraw process in the wallet. After - specifying the desired amount, the wallet should show you the details of the - fiat wire transfer that must be made for the cash in to be completed. Once the - money has arrived at the fiat bank account, Nexus will obtain the transaction - data and the regional currency bank will create the corresponding amount in - regional currency, crediting the GNU Taler exchange account. In turn, the - exchange will issue the respective amount to your wallet. - - For testing, you should be able to *deposit* regional currency directly - into a LibEuFin Bank account from the Taler wallet. Once the exchange - has credited the regional currency account, log into the bank account - using the Web interface. Assuming the cash out rules are satisfied, you - should then be able to start a cash out operation.