taler-docs

commit f98568776d9e6d0f1515ff865ef8653096df3bec
parent 8988dc7d187973c97e3d74983136e24c47c913c8
Author: Florian Dold <dold@taler.net>
Date:   Sat, 29 Aug 2026 16:58:16 +0200

merchant API: document template pay duration fallback

Diffstat:
M
core/api-merchant.rst
 | 
4
++--
M
design-documents/073-extended-merchant-template.rst
 | 
10
++++++----

2 files changed, 8 insertions(+), 6 deletions(-)
diff --git a/core/api-merchant.rst b/core/api-merchant.rst
@@ -1431,8 +1431,8 @@ open or deferred.
       // Since protocol **v34**.
       max_amount?: Amount;
 
-      // The time the customer need to pay before his order will be deleted.
-      // It is deleted if the customer did not pay and if the duration is over.
+      // Time available to pay before the order expires unpaid.  If omitted or
+      // zero, the instance's default pay delay is used.  "forever" is invalid.
       pay_duration?: RelativeTime;
 
       // How long will customers have to access / read / pick-up
diff --git a/design-documents/073-extended-merchant-template.rst b/design-documents/073-extended-merchant-template.rst
@@ -161,8 +161,9 @@ New contract type has next structure:
         // verifies that amount equals selected products + tip.
         request_tip?: boolean;
 
-        // Time window to pay before the order expires unfulfilled.
-        pay_duration: RelativeTime;
+        // Time window to pay before the order expires unfulfilled. If omitted
+        // or zero, the instance's default pay delay is used. "forever" is invalid.
+        pay_duration?: RelativeTime;
 
         // Selects all products from merchant inventory and overrides
         // selected_categories and selected_products.
@@ -270,8 +271,9 @@ per-product logic when available.
      // Request the wallet to offer a tip entry UI.
      request_tip?: boolean;
 
-     // Time the customer has to pay before the order expires unpaid.
-     pay_duration: RelativeTime;
+     // Time the customer has to pay before the order expires unpaid. If omitted
+     // or zero, the instance's default pay delay is used. "forever" is invalid.
+     pay_duration?: RelativeTime;
 
      // Information about the resolved products.
      inventory_payload?: WalletInventoryPayload;