taler-docs

commit 3b174f7eb00f78a6ffb0a246ffd593d4de26e0dc
parent 6e583f0e57e0fa8c9d6d4efbd781d2465e4dacb4
Author: Christian Grothoff <christian@grothoff.org>
Date:   Sun, 29 Mar 2026 23:02:19 +0200

fix spec issues

Diffstat:
M
core/exchange/get-reserves-RESERVE_PUB.rst
 | 
6
+++---
M
core/exchange/post-recoup-withdraw.rst
 | 
13
++++++++++++-
M
core/merchant/get-private-products.rst
 | 
2
+-

3 files changed, 16 insertions(+), 5 deletions(-)
diff --git a/core/exchange/get-reserves-RESERVE_PUB.rst b/core/exchange/get-reserves-RESERVE_PUB.rst
@@ -9,15 +9,15 @@
   **Response:**
 
   :http:statuscode:`200 OK`:
-    The exchange responds with a `ReserveSummary` object; the reserve was known to the exchange.
+    The exchange responds with a `ReserveSummaryResponse` object; the reserve was known to the exchange.
   :http:statuscode:`404 Not found`:
     The reserve key does not belong to a reserve known to the exchange.
 
   **Details:**
 
-  .. ts:def:: ReserveSummary
+  .. ts:def:: ReserveSummaryResponse
 
-    interface ReserveSummary {
+    interface ReserveSummaryResponse {
       // Balance left in the reserve.
       balance: Amount;
 
diff --git a/core/exchange/post-recoup-withdraw.rst b/core/exchange/post-recoup-withdraw.rst
@@ -23,7 +23,9 @@
   **Response:**
 
   :http:statuscode:`200 OK`:
-    The request was successful, and the response is a `ReserveSummary`.
+    The request was successful, and the response is
+    a `ReoupWithdrawResponse`.
+    FIXME: Does not really provide additional information. Maybe replace with a 204 instead?
   :http:statuscode:`403 Forbidden`:
     A coin's signature is invalid.
     This response comes with a standard `ErrorDetail` response.
@@ -140,3 +142,12 @@
       // created by this coin's private key.
       coin_sig: EddsaSignature;
     }
+
+  .. ts:def:: RecoupWithdrawResponse
+
+    interface RecoupWithdrawResponse {
+      // Public key of the reserve that will receive the recoup.
+      // Will be the same as the one from the original withdraw.
+      reserve_pub: EddsaPublicKey;
+
+    }
diff --git a/core/merchant/get-private-products.rst b/core/merchant/get-private-products.rst
@@ -11,7 +11,7 @@
   :query category_filter: *Optional*. Only returns products that are in a category where the category name contains the given text as a substring. Matching is case-insensitive. Since protocol **v23**.
   :query name_filter: *Optional*. Only returns products where the product name contains the given text as a substring. Matching is case-insensitive. Since protocol **v23**.
   :query description_filter: *Optional*. Only returns products where the product description contains the given text as a substring. Matching is case-insensitive. Since protocol **v23**.
-  :query product_group_serial: *Optional*. Only returns products where the product group serial matches the given value. Since protocol **v25**.
+  :query product_group_filter: *Optional*. Only returns products where the product group ID matches the given value. Since protocol **v25**.
 
   **Response:**