commit 75af3379c904124ccec236a774911787d078a842
parent c50795c053a5c8d6b79a90ecc579f1cac659618a
Author: Christian Grothoff <christian@grothoff.org>
Date: Thu, 13 Nov 2025 18:54:44 +0100
clarifications related to 10606
Diffstat:
1 file changed, 10 insertions(+), 0 deletions(-)
diff --git a/core/api-merchant.rst b/core/api-merchant.rst
@@ -262,6 +262,7 @@ such as the implemented version of the protocol and the currency used.
// Default payment delay for new instances.
// This is the default to use for new instances, see the instance value for
// the instance-specific default.
+ // A value of "forever" is not allowed.
// @since **v22**
default_pay_delay: RelativeTime;
@@ -269,12 +270,14 @@ such as the implemented version of the protocol and the currency used.
// refunds be allowed by default?
// This is the default to use for new instances, see the instance value for
// the instance-specific default.
+ // A value of "forever" is not allowed.
// @since **v22**
default_refund_delay: RelativeTime;
// Default wire transfer delay for new instances.
// This is the default to use for new instances, see the instance value for
// the instance-specific default.
+ // A value of "forever" is not allowed.
// @since **v22**
default_wire_transfer_delay: RelativeTime;
@@ -1823,12 +1826,14 @@ Setting up instances
// If the frontend does NOT specify a payment deadline, how long should
// offers we make be valid by default?
+ // A value of "forever" is not allowed.
// Optional @since **v22** (before the setting was mandatory).
// If not provided, the previous setting will now simply be preserved.
default_pay_delay?: RelativeTime;
// If the frontend does NOT specify a refund deadline, how long should
// refunds be allowed by default? Added on top of the payment deadline.
+ // A value of "forever" is not allowed.
// @since **v22**
default_refund_delay?: RelativeTime;
@@ -1837,6 +1842,7 @@ Setting up instances
// executing the wire transfer? This delay is added on top of
// the refund deadline and afterwards subject to rounding
// via the ``default_wire_transfer_rounding_interval``.
+ // A value of "forever" is not allowed.
// Optional @since **v22** (before the setting was mandatory).
// If not provided, the previous setting will now simply be preserved.
default_wire_transfer_delay?: RelativeTime;
@@ -3395,6 +3401,7 @@ Creating orders
// used. Note that both this value and the backend default
// will be ignored if ``refund_deadline`` is set in ``order``
// as the ``refund_deadline`` takes precedence.
+ // A value of "forever" is not allowed.
refund_delay?: RelativeTime;
// Specifies the payment target preferred by the client. Can be used
@@ -3523,17 +3530,20 @@ Creating orders
// After this deadline has passed, no refunds will be accepted.
// Overrides deadline calculated from ``refund_delay`` in
// ``PostOrderRequest``.
+ // A value of "never" is not allowed.
refund_deadline?: Timestamp;
// After this deadline, the merchant won't accept payments for the contract.
// Overrides deadline calculated from default pay delay configured in
// merchant backend.
+ // A value of "never" is not allowed.
pay_deadline?: Timestamp;
// Transfer deadline for the exchange. Must be in the deposit permissions
// of coins used to pay for this order.
// Overrides deadline calculated from default wire transfer delay
// configured in merchant backend. Must be after refund deadline.
+ // A value of "never" is not allowed.
wire_transfer_deadline?: Timestamp;
// Base URL of the (public!) merchant backend API.