spec for #8608

1 files changed, 25 insertions, 1 deletions

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index d21d8073..ebd5647d 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -123,7 +123,7 @@ such as the implemented version of the protocol and the currency used.
 .. http:get:: /config
 
   Return the protocol version and currency supported by this merchant backend.
-  This specification corresponds to ``current`` protocol being version **10**.
+  This specification corresponds to ``current`` protocol being version **11**.
 
   **Response:**
 
@@ -3048,6 +3048,30 @@ Removing template
 Using template
 ----------------
 
+.. http:get:: [/instances/$INSTANCE]/templates/$TEMPLATE_ID
+
+  This is used to obtain information about a specific template by wallets
+  before they ask the user to fill in details.
+  This endpoint is available since protocol **v11**.
+
+  **Response:**
+
+  :http:statuscode:`200 OK`:
+    The backend has successfully returned the detailed information about a specific template.
+    Returns a `WalletTemplateDetails`.
+  :http:statuscode:`404 Not found`:
+    The instance or template(ID) is unknown to the backend.
+
+  .. ts:def:: WalletTemplateDetails
+
+    interface WalletTemplateDetails {
+
+      // Hard-coded information about the contrac terms
+      // for this template.
+      template_contract: TemplateContractDetails;
+   }
+
+
 .. http:post:: [/instances/$INSTANCES]/templates/$TEMPLATE_ID
 
   This using template can be modified by everyone and will be used to create order.