commit ce75d29a92777f108bac646b979f65c5ecec28df
parent edb8af1ef85db9433b315562fbcc5a3ff6c9273a
Author: Florian Dold <florian@dold.me>
Date: Wed, 24 Sep 2025 17:17:24 +0200
DD68: post-MVP merchant user experience
Diffstat:
1 file changed, 33 insertions(+), 1 deletion(-)
diff --git a/design-documents/068-tokens-roadmap.rst b/design-documents/068-tokens-roadmap.rst
@@ -90,7 +90,7 @@ User Experience
Donau MVP
^^^^^^^^^
-MVP flow:
+**Donor / wallet user:**
1. User opens Taler wallet, goes to ``Settings -> Donations``
2. In the initial state, user can enter a donau base URL and tax ID.
@@ -106,9 +106,16 @@ MVP flow:
5. User can view their current donation statement via ``Settings -> Donations -> Show donation statements``.
+**Merchant:**
+
+In the MVP, the merchant backend will be set up via the REST API,
+we won't provide any SPA support.
+
Donau Next Iteration
^^^^^^^^^^^^^^^^^^^^
+**Donor / wallet user:**
+
In the post-MVP iteration, we want to improve the onboarding experience. The
wallet should ask *during* a payment that supports a donation receipt if the
user wants to set up donation receipts.
@@ -117,6 +124,31 @@ As the merchant might offer multiple donau URLs (each for their own financial do
the user needs to be shown all possible donaus with their respective financial domain.
After choosing the donau, the user needs to enter their tax payer identifier.
+**Merchant:**
+
+In the post-MVP iteration, the merchant SPA should allow a merchant
+to set up the donau integration. This includes the following steps:
+
+1. The merchant registers a charity ID with the donau.
+
+ * The SPA should probably explain this process and
+ show the merchant public key, which needs to be given
+ to the donation authority for the charity registration process.
+ * The actual registration happens via a side channel (e-mail, postal, in
+ person, ...), there is no protocol for this.
+ * As a result of the registration, the merchant obtains a ``charity_id``
+
+2. The merchant SPA provides a configuration page for the
+ supported donation authorities, where the merchant can enter the donau base URL
+ and charity ID.
+
+3. For each configured charity, there should be a details page
+ that shows the used and remaining donation amount.
+
+4. When creating an order via the SPA, there should be an option
+ labled "this is a donation".
+
+
Test Plan
=========
