taler-docs

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

025-withdraw-from-wallet.rst (1912B)


      1 DD 25: Withdraw coins manually starting from the wallet
      2 #######################################################
      3 
      4 Summary
      5 =======
      6 
      7 This document presents the design discussion about the manual withdraw screens
      8 
      9 Motivation
     10 ==========
     11 
     12 To have a way to initiate a withdrawal process and complete with a bank that is
     13 not aware of GNU Taler
     14 
     15 Proposed Solution
     16 =================
     17 
     18 Access to the feature
     19 ^^^^^^^^^^^^^^^^^^^^^
     20 
     21 Adding a withdraw button in the main balance page to initiate the process.
     22 
     23 This feature can be use in the Pay call-to-action when there is not enough coins.
     24 
     25 Start
     26 ^^^^^
     27 
     28 This screen the user will be able to select the currency from a list of known
     29 currencies, switch the exchange, go to a page to add an exchange and define an
     30 amount to be withdraw.
     31 
     32 .. image:: ../images/wallet-start-manual-withdraw.svg
     33   :width: 800
     34 
     35 
     36 Success
     37 ^^^^^^^
     38 
     39 Here the user will see the account details where it needs to send money to
     40 complete the withdrawal.
     41 
     42 .. image:: ../images/wallet-confirm-withdraw.svg
     43   :width: 800
     44 
     45 Transaction history
     46 ^^^^^^^^^^^^^^^^^^^
     47 
     48 The account information should be added into the Withdrawal Transaction detail
     49 screen if the withdrawal is still pending. This will also affect the use case
     50 when the user started the transaction from a taler-aware bank (in which case the
     51 user doesn't need to do an extra step to complete the process) so the text
     52 should be consistent in both scenarios.
     53 
     54 Alternatives
     55 ============
     56 
     57 * removing the amount field, the exchange will send coins equal to the amount it received
     58 
     59 * showing the fees, can we calculate the withdrawal fee?
     60 
     61 * should we show the terms of service?
     62 
     63 * exchange field first has been discussed, but the exchange list its only showing the
     64   current currency exchanges, the user need to switch the currency first. Adding a
     65   new exchange should be done in a different context that can be accessed using the
     66   ``add exchange`` link