commit 8adbb987608e96c374e48a53e76f39e4bd16ff74
parent 8385491240fce267cdc43aafca28800caefe5cc3
Author: Christian Grothoff <christian@grothoff.org>
Date: Fri, 20 Feb 2026 22:49:20 +0100
spec update for merchant v27: #11123/#11119
Diffstat:
5 files changed, 52 insertions(+), 1 deletion(-)
diff --git a/core/merchant/get-config.rst b/core/merchant/get-config.rst
@@ -1,7 +1,7 @@
.. http:get:: /config
Return the protocol version and currency supported by this merchant backend.
- This specification corresponds to ``current`` protocol being version **v24**.
+ This specification corresponds to ``current`` protocol being version **v27**.
**Response:**
diff --git a/core/merchant/get-private-accounts-H_WIRE.rst b/core/merchant/get-private-accounts-H_WIRE.rst
@@ -35,4 +35,20 @@
// true if this account is active,
// false if it is historic.
active: boolean;
+
+ // Additional text to include in the wire transfer subject when
+ // settling the payment. Note that the merchant MUST use this
+ // consistently for the same ``merchant_pub`` and ``merchant_payto_uri``
+ // as during aggregation *any* of these values may be selected
+ // for the actual aggregated wire transfer. If a merchant wants
+ // to use different ``extra_subject`` values for the same IBAN,
+ // it should thus create multiple instances (with different
+ // ``merchant_pub`` values). When changing the ``extra_subject``,
+ // the change may thus not be immediately reflected in the
+ // settlements.
+ //
+ // Must match [a-zA-Z0-9-.:]{1, 40}
+ //
+ // Optional. Since **v27**.
+ extra_wire_subject_metadata?: string;
}
diff --git a/core/merchant/patch-private-accounts-H_WIRE.rst b/core/merchant/patch-private-accounts-H_WIRE.rst
@@ -33,4 +33,20 @@
// If the argument is omitted, the old credentials
// are simply preserved.
credit_facade_credentials?: FacadeCredentials;
+
+ // Additional text to include in the wire transfer subject when
+ // settling the payment. Note that the merchant MUST use this
+ // consistently for the same ``merchant_pub`` and ``merchant_payto_uri``
+ // as during aggregation *any* of these values may be selected
+ // for the actual aggregated wire transfer. If a merchant wants
+ // to use different ``extra_subject`` values for the same IBAN,
+ // it should thus create multiple instances (with different
+ // ``merchant_pub`` values). When changing the ``extra_subject``,
+ // the change may thus not be immediately reflected in the
+ // settlements.
+ //
+ // Must match [a-zA-Z0-9-.:]{1, 40}
+ //
+ // Optional. Since **v27**.
+ extra_wire_subject_metadata?: string;
}
diff --git a/core/merchant/post-private-accounts.rst b/core/merchant/post-private-accounts.rst
@@ -44,6 +44,21 @@
// To really delete credentials, set them to the type: "none".
credit_facade_credentials?: FacadeCredentials;
+ // Additional text to include in the wire transfer subject when
+ // settling the payment. Note that the merchant MUST use this
+ // consistently for the same ``merchant_pub`` and ``merchant_payto_uri``
+ // as during aggregation *any* of these values may be selected
+ // for the actual aggregated wire transfer. If a merchant wants
+ // to use different ``extra_subject`` values for the same IBAN,
+ // it should thus create multiple instances (with different
+ // ``merchant_pub`` values). When changing the ``extra_subject``,
+ // the change may thus not be immediately reflected in the
+ // settlements.
+ //
+ // Must match [a-zA-Z0-9-.:]{1, 40}
+ //
+ // Optional. Since **v27**.
+ extra_wire_subject_metadata?: string;
}
.. ts:def:: FacadeCredentials
diff --git a/manpages/taler-exchange-wire-gateway-client.1.rst b/manpages/taler-exchange-wire-gateway-client.1.rst
@@ -28,6 +28,7 @@ Synopsis
[**-u** *USERNAME* | **--user=**\ \ *USERNAME*]
[**-v** | **--version**]
[**-w** *ROW* | **--since-when=**\ \ *ROW*]
+[**-x** *META* | **--extra=**\ \ *META*]
Description
===========
@@ -105,6 +106,9 @@ Options
**-w** *ROW* \| **--since-when=**\ \ *ROW*
Specifies a *ROW* from which the history should be obtained. If not given, the 10 youngest transactions are returned.
+**-x** *METADATA* \| **--extra=**\ \ *METADATA*
+ Specifies additional optional *METADATA* to be used in the wire transfer subject of a credit transfer.
+
See Also
========
