[taler-docs] branch master updated: fix spec for donau

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new c104cb17 fix spec for donau
c104cb17 is described below

commit c104cb17bbe8d7e11c8335206a09f733a207afef
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Tue Dec 24 10:15:37 2024 +0100

    fix spec for donau
---
 core/api-merchant.rst | 37 +++++++++++++++++++++++++++----------
 1 file changed, 27 insertions(+), 10 deletions(-)

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 4d7eeebb..e7d8eda0 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -2711,9 +2711,9 @@ Creating orders
       // Tax receipt output.
       type: "tax-receipt";
 
-      // Base URL of the donation authority that will
-      // issue the tax receipt.
-      donau_url: string;
+      // Total amount that will be on the tax receipt.
+      // Optional, if missing the full amount will be on the receipt.
+      amount?: Amount;
 
     }
 
@@ -4613,13 +4613,13 @@ The contract terms must have the following structure:
 
     // Number of tokens of this type required.
     // Defaults to one if the field is not provided.
-    number?: Integer;
+    count?: Integer;
   };
 
 .. ts:def:: ContractOutput
 
   // For now, only tokens are supported as outputs.
-  type ContractOutput = ContractOutputToken;
+  type ContractOutput = ContractOutputToken | ContractOutputTaxReceipt;
 
 .. ts:def:: ContractOutputToken
 
@@ -4630,14 +4630,31 @@ The contract terms must have the following structure:
     // 'token_families' map on the top-level.
     token_family_slug: string;
 
+    // Number of tokens to be issued.
+    // Defaults to one if the field is not provided.
+    count?: Integer;
+
     // Index of the public key for this output token
-    // in the
-    `ContractTokenFamily` ``keys`` array.
+    // in the `ContractTokenFamily` ``keys`` array.
     key_index: integer;
 
-    // Number of tokens to be issued.
-    // Defaults to one if the field is not provided.
-    number?: Integer;
+  }
+
+.. ts:def:: ContractOutputTaxReceipt
+
+  interface ContractOutputTaxReceipt {
+
+    // Tax receipt output.
+    type: "tax-receipt";
+
+    // Array of base URLs of donation authorities that can be
+    // used to issue the tax receipts. The client must select one.
+    donau_urls: string[];
+
+    // Total amount that will be on the tax receipt.
+    // Optional, if missing the full amount will be on the receipt.
+    amount?: Amount;
+
   }
 
 .. ts:def:: ContractTokenFamily

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.