taler-docs

commit 41bcc2a2b2ff0d6e70a8ac72bd684e0895b3ce48
parent 388aefffc9d2941b64542001a4277bc56b8daacb
Author: Christian Grothoff <christian@grothoff.org>
Date:   Thu, 12 Sep 2024 23:23:05 +0200

add new option(s) for #9189

Diffstat:
M
core/api-exchange.rst
 | 
17
+++++++++++++++++
M
manpages/taler.conf.5.rst
 | 
13
+++++++++++++

2 files changed, 30 insertions(+), 0 deletions(-)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
@@ -85,6 +85,11 @@ possibly by using HTTPS.
       // as a currency code ("USD" or "EUR").
       currency: string;
 
+      // Shopping URL where users may find shops that accept
+      // digital cash issued by this exchange.
+      // @since **v21**.
+      shopping_url?: string;
+
       // How wallets should render this currency.
       currency_specification: CurrencySpecification;
 
@@ -154,9 +159,21 @@ possibly by using HTTPS.
       // The exchange's currency or asset unit.
       currency: string;
 
+      // Shopping URL where users may find shops that accept
+      // digital cash issued by this exchange.
+      // @since protocol **v21**.
+      shopping_url?: string;
+
       // How wallets should render this currency.
       currency_specification: CurrencySpecification;
 
+      // Small(est?) amount that can likely be transferred to
+      // the exchange. Should be the default amount for KYC
+      // authentication wire transfers to this exchange.
+      // Optional, not present if not known or not configured.
+      // @since protocol **v21**.
+      tiny_amount?: Amount;
+
       // Absolute cost offset for the STEFAN curve used
       // to (over) approximate fees payable by amount.
       stefan_abs: Amount;
diff --git a/manpages/taler.conf.5.rst b/manpages/taler.conf.5.rst
@@ -155,6 +155,19 @@ MASTER_PUBLIC_KEY
   is also used by the **auditor** to determine the public key of the
   exchange which it is auditing.
 
+TINY_AMOUNT
+  Small amount that can be transferred to the exchange for the
+  KYC authentication wire transfers. Should be given as a hint
+  for merchants what amount they need to transfer to begin the
+  KYC transfer. Note that the amount is not enforced by the
+  exchange *and* that this option is optional. However, if it is
+  not given, merchants will have to guess what amount to transfer,
+  so it really should be configured.
+
+SHOPPING_URL
+  Web URL where users can discover shops that accept digital cash
+  offered by this exchange. Optional, but highly recommended.
+
 STEFAN_ABS
   Absolute amount to add as an offset in the STEFAN fee approximation
   curve (see DD47).  Defaults to CURRENCY:0 if not specified.