path: root/api-bank.rst
diff options
authorMarcello Stanisci <>2017-11-29 20:28:55 +0100
committerMarcello Stanisci <>2017-11-29 20:30:38 +0100
commitb264dc7e5eaf3d08f62b4af1f3dbf44db62c3188 (patch)
tree8ddfbdd63ae8e69277a38502380268ca95dabef6 /api-bank.rst
parentbc72d8c5d0841949c66c5104ad04640d6660d62d (diff)
~70% of #5042
Diffstat (limited to 'api-bank.rst')
1 files changed, 22 insertions, 8 deletions
diff --git a/api-bank.rst b/api-bank.rst
index 7ee7cab..acce959 100644
--- a/api-bank.rst
+++ b/api-bank.rst
@@ -173,11 +173,9 @@ User API
Interactions with wallet
-The interaction between the bank and the wallet does *not* use JavaScript.
-The interaction is needed to (1) make some elements visible only if a wallet
-is installed, and (2) to give the wallet information about a new withdraw
+A bank and a wallet need to communicate for (1) make some elements visible
+only if the wallet is installed, (2) exchange information when the user withdraws
Make elements visible.
@@ -198,7 +196,23 @@ wallet is *not* installed. This special page will hide any element of
the class ``taler-install-show``; it can be downloaded at the following
URI: ``git://``.
-New withdrawal information.
+Withdrawing coins.
+After the user confirms the withdrawal, the bank must send back the following
+information via HTTP headers:
+* ``X-Taler-Operation: create-reserve``
+* ``X-Taler-Callback-Url:``; this URL will be automatically visited by the wallet after the user confirms the exchange.
+* ``X-Taler-Wt-Types: '["test"]'``
+* ``X-Taler-Amount: <amount_string>``; stringified Taler-style JSON :ref:`amount <amount>`.
+* ``X-Taler-Sender-Wire: <wire_details>``; stringified WireDetails_.
+.. _WireDetails:
+.. code-block:: tsref
+ interface WireDetails {
+ type: string; // Only 'test' value admitted so far.
+ bank_uri: URI of the bank.
+ account_number: bank account number of the user attempting to withdraw.
+ }