diff options
author | Marcello Stanisci <stanisci.m@gmail.com> | 2017-11-29 20:28:55 +0100 |
---|---|---|
committer | Marcello Stanisci <stanisci.m@gmail.com> | 2017-11-29 20:30:38 +0100 |
commit | b264dc7e5eaf3d08f62b4af1f3dbf44db62c3188 (patch) | |
tree | 8ddfbdd63ae8e69277a38502380268ca95dabef6 | |
parent | bc72d8c5d0841949c66c5104ad04640d6660d62d (diff) | |
download | docs-b264dc7e5eaf3d08f62b4af1f3dbf44db62c3188.tar.gz docs-b264dc7e5eaf3d08f62b4af1f3dbf44db62c3188.tar.bz2 docs-b264dc7e5eaf3d08f62b4af1f3dbf44db62c3188.zip |
~70% of #5042
-rw-r--r-- | api-bank.rst | 30 |
1 files changed, 22 insertions, 8 deletions
diff --git a/api-bank.rst b/api-bank.rst index 7ee7cab5..acce9597 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 -operation. +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 +coins. 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://taler.net/web-common/taler-fallback.css``. -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: http://callback.example.com/``; 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_. -TBD. +.. _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. + } |