taler-docs

commit eaabc8c859ef2736e0e3d0e7bd77e610d8ea95c4
parent af74b5549fe7374afba54d55a7ca649254978bed
Author: Christian Grothoff <christian@grothoff.org>
Date:   Wed, 12 Aug 2026 23:47:42 +0200

expand exchange API for #10713

Diffstat:
M
core/api-exchange.rst
 | 
4
+++-
M
core/exchange/get-transfers-WTID.rst
 | 
9
+++++++++

2 files changed, 12 insertions(+), 1 deletion(-)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
@@ -30,7 +30,7 @@ defines all specific terms used in this section.
 Version History
 ---------------
 
-The currently implemented protocol version is **v38**.
+The currently implemented protocol version is **v39**.
 
 * Wallet-core is currently targeting **vXX**.
 * The merchant is currently targeting **v34**.
@@ -50,6 +50,8 @@ The currently implemented protocol version is **v38**.
 * ``v36``: adds ``kyc_swap_tos_acceptance`` to :http:get:`/keys </keys>`
 * ``v37``: adds :http:get:`/aml/$OFFICER_PUB/wallet-credit </aml/$OFFICER_PUB/wallet-credit>` endpoint
 * ``v38``: adds ``build_version`` to :http:get:`/config </config>`
+* ``v39``: adds ``exchange_payto_uri`` to
+           :http:get:`/transfers/$WTID </transfers/$WTID>`
 
 **Upcoming versions:**
 
diff --git a/core/exchange/get-transfers-WTID.rst b/core/exchange/get-transfers-WTID.rst
@@ -41,6 +41,15 @@
       // Hash of the payto:// account URI (identical for all deposits).
       h_payto: FullPaytoHash;
 
+      // Full payto://-URI of the exchange's own bank account that
+      // was debited to make the wire transfer.  Merchants may show
+      // this to their staff to help locate the incoming transfer in
+      // their bank statement.  Optional, as the exchange does not
+      // have this information for wire transfers that were executed
+      // before the exchange started to record it.
+      // @since protocol **v39**.
+      exchange_payto_uri?: string;
+
       // Time of the execution of the wire transfer by the exchange.
       execution_time: Timestamp;