summaryrefslogtreecommitdiff
path: root/taler-exchange-manual.rst
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2021-01-06 20:00:11 +0100
committerChristian Grothoff <christian@grothoff.org>2021-01-06 20:00:11 +0100
commit44931d751ef0dd091b13cecf05e9c869cab6528c (patch)
tree0227b3dd4c53a1f283cf5aef2367aaf4d91f4b04 /taler-exchange-manual.rst
parentb1841f2970d4f205774a0f0b667bd04770ca6c07 (diff)
parent275de898eeff924b0658adbbc3cd51cadcd749d6 (diff)
downloaddocs-44931d751ef0dd091b13cecf05e9c869cab6528c.tar.gz
docs-44931d751ef0dd091b13cecf05e9c869cab6528c.tar.bz2
docs-44931d751ef0dd091b13cecf05e9c869cab6528c.zip
Merge branch 'master' of git+ssh://git.taler.net/docs
Diffstat (limited to 'taler-exchange-manual.rst')
-rw-r--r--taler-exchange-manual.rst13
1 files changed, 10 insertions, 3 deletions
diff --git a/taler-exchange-manual.rst b/taler-exchange-manual.rst
index 2973d1a1..2d476711 100644
--- a/taler-exchange-manual.rst
+++ b/taler-exchange-manual.rst
@@ -81,6 +81,13 @@ currencies such as USD or EUR. Similarly, the Taler exchange must
interact with a bank. The bank of the exchange holds the exchange’s
funds in an escrow account.
+Note that, given the technical burden (XML-based communications,
+additional cryptography, and a vast variety of standards) due to
+interact with banks, the exchange uses a intermediary system to talk
+to its bank. Such intermediary system abstracts the native banking
+protocol by exposing the *Taler Wire Gateway API*; this way, the exchange
+can conduct its banking operations in a simplified and JSON-based style.
+
When customers wire money to the escrow account, the bank notifies the
exchange about the incoming wire transfers. The exchange then creates a
*reserve* based on the subject of the wire transfer. The wallet which
@@ -136,7 +143,7 @@ components:
The ``taler-exchange-transfer`` tool is responsible for actually
executing the aggregated wire transfers. It is the only process
that needs to have the credentials to execute outgoing wire
- transfers. The tool uses the Taler Wire REST API to execute
+ transfers. The tool uses the Taler Wire Gateway API to execute
wire transfers. This API is provided by the Taler Python Bank
for stand-alone deployments (like those with ``KUDOS``) and
by LibEuFin. LibEuFin is an adapter which maps the Taler Wire
@@ -146,7 +153,7 @@ components:
The ``taler-exchange-wirewatch`` tool is responsible for observing
incoming wire transfers to the exchange. It needs to have the
credentials to obtain a list of incoming wire transfers.
- The tool also uses the Taler Wire REST API to observe such
+ The tool also uses the Taler Wire Gateway API to observe such
incoming transfers. It is possible that observing incoming and
making outgoing wire transfers is done via different bank accounts
and/or credentials.
@@ -360,7 +367,7 @@ merchant).
Key options include:
-- ``[exchange/MASTER_PRIV_FILE]``: Path to the exchange’s master private file. Only needs to be provided on the offline system where the ``taler-exchange-offline`` command is used.
+- ``[exchange-offline/MASTER_PRIV_FILE]``: Path to the exchange’s master private file. Only needs to be provided on the offline system where the ``taler-exchange-offline`` command is used.
- ``[exchange/MASTER_PUBLIC_KEY]``: Must specify the exchange’s master public key. Needed for the exchange to verify information signed by the offline system.