taler-docs

commit 1a1283f5fff6adc472432d2d4553450d112da028
parent 6073f9c76f707876eeb37a9c05aa20959c978876
Author: Christian Grothoff <grothoff@gnunet.org>
Date:   Tue,  3 Feb 2026 12:17:20 +0100

draft API extension for #10965

Diffstat:
M
core/api-merchant.rst
 | 
34
+++++++++++++++++++++++++++++++++-

1 file changed, 33 insertions(+), 1 deletion(-)
diff --git a/core/api-merchant.rst b/core/api-merchant.rst
@@ -44,7 +44,7 @@ Android PoS app is currently targeting **v20**.
   for periodic report generation and inventory-based templates,
   new long-polling for KYC and features for templates to support
   session-based payments
-* ``v26``: adds unclaim endpoint
+* ``v26``: adds unclaim endpoint, enhanced settlement reporting
 
 **Upcoming versions:**
 
@@ -5161,6 +5161,17 @@ Querying expected wire transfers
       // (a matching entry exists in /private/transfers)
       confirmed: boolean;
 
+      // List of orders that are settled by this wire
+      // transfer according to the exchange.  Only
+      // available if ``last_http_status`` is 200.
+      // @since **v26**
+      reconciliation_details?: ExchangeTransferReconciliationDetails[];
+
+      // Wire fee paid by the merchant. Only
+      // available if ``last_http_status`` is 200.
+      // @since **v26**
+      wire_fee: Amount;
+
       // Last HTTP status we received from the exchange, 0 for
       // none (incl. timeout)
       last_http_status: Integer;
@@ -5172,6 +5183,27 @@ Querying expected wire transfers
       last_error_detail?: string;
     }
 
+  .. ts:def:: ExchangeTransferReconciliationDetails
+
+    interface ExchangeTransferReconciliationDetails {
+
+      // ID of the order for which these are the
+      // reconciliation details.
+      order_id: string;
+
+      // Remaining deposit total to be paid,
+      // that is the total amount of the order
+      // minus any refunds that were granted.
+      // The actual amount to be wired is this
+      // amount minus ``deposit_fee`` and (overall)
+      // minus the ``wire_fee`` of the transfer.
+      remaining_deposit: Amount;
+
+      // Deposit fees paid to the exchange for this order.
+      deposit_fee: Amount;
+
+    }
+
 
 Deleting confirmed wire transfer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^