bank landing: one-step withdraw-exchange + Android/iOS links

Short intro; wallet install; single taler://withdraw-exchange QR.
This commit is contained in:
Hernâni Marques 2026-07-10 18:05:00 +02:00
parent 8729e69e87
commit 5af039ca03
No known key found for this signature in database
2 changed files with 96 additions and 145 deletions

View file

@ -13,33 +13,25 @@ open your own bank account, and point merchants at `taler.hacktivism.ch`.
## User flow (documented on the page)
### Two steps (only path)
Same **one-step** pattern as [taler-ops.ch Android/iOS guides](https://taler-ops.ch/en/users-android.html):
1. **`taler://add-exchange/exchange.hacktivism.ch/`** — add exchange, accept ToS.
2. **Demo withdraw URI** from `withdraw.uri` — bank-integrated withdraw (default `GOA:10`).
1. **Install wallet** — Android (Play Store / F-Droid) and iOS (App Store), plus hub `wallet.taler.net`.
2. **One QR / link**`taler://withdraw-exchange/exchange.hacktivism.ch/`
Adds the GOA exchange **and** starts withdrawal (accept ToS → enter amount).
If the demo withdraw is already **confirmed/aborted**, the page points at the bank UI instead.
The old two-step path (`taler://add-exchange/…` + demo `taler://withdraw/…` from `withdraw.uri`) is **removed** from the landing.
Optional: bank UI (`/webui/`) and merchant (`taler.hacktivism.ch`) stay further down.
### CLI sketch (fresh wallet DB)
```bash
# equivalent one-step in CLI terms:
taler-wallet-cli exchanges add https://exchange.hacktivism.ch/
taler-wallet-cli exchanges accept-tos https://exchange.hacktivism.ch/
taler-wallet-cli withdraw accept-uri --exchange https://exchange.hacktivism.ch/ 'taler://withdraw/…'
# then bank confirm (demo often auto-confirms) + run-until-done
# then withdraw from the exchange (amount chosen in wallet UI)
```
### URI note (`:443`)
libeufin may emit:
```text
taler://withdraw/bank.hacktivism.ch:443/taler-integration/<uuid>
```
Explicit default HTTPS port. Valid for wallets; the landing page **strips `:443`** for
QR / open links when the host is the public bank name. Both forms work.
---
## Live stats (in bank container)