taler-docs

commit 6073f9c76f707876eeb37a9c05aa20959c978876
parent ed1887780e88ae26f571b0c8200ddf467821b05f
Author: Christian Grothoff <grothoff@gnunet.org>
Date:   Tue,  3 Feb 2026 12:08:26 +0100

draft API extension for #10964

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

1 file changed, 30 insertions(+), 0 deletions(-)
diff --git a/core/api-merchant.rst b/core/api-merchant.rst
@@ -4622,6 +4622,11 @@ Inspecting orders
       // available, otherwise empty array.
       wire_details: TransactionWireTransfer[];
 
+      // Details about how the order is expected to be
+      // settled by each exchange.
+      // @since **v26**.
+      settlement_details: ExchangeOrderSettlementDetails[];
+      
       // Groups about trouble obtaining wire transfer details,
       // empty array if no trouble were encountered.
       // @deprecated in protocol **v6**.
@@ -4743,6 +4748,31 @@ Inspecting orders
       expected_transfer_serial_id: Integer;
     }
 
+  .. ts:def:: ExchangeOrderSettlementDetails
+
+    interface ExchangeOrderSettlementDetails {
+      // Responsible exchange.
+      exchange_url: string;
+
+      // Wire fee anticipated by the merchant. Note
+      // that it might not be charged at all if the
+      // order is aggregated with another order.
+      wire_fee: Amount;
+
+      // Deposit fees to be paid to the
+      // exchange for this order.
+      deposit_fee: Amount;
+
+      // 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 possibly
+      // minus ``wire_fee``.
+      remaining_deposit: Amount;
+
+    }
+
   .. ts:def:: TransactionWireReport
 
     interface TransactionWireReport {