[taler-docs] branch master updated: more work on merchant API spec

[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 24a772d  more work on merchant API spec
24a772d is described below

commit 24a772d0b6e7fca0635aca2d808e36a62a43e825
Author: Christian Grothoff <address@hidden>
AuthorDate: Mon Apr 13 22:02:47 2020 +0200

    more work on merchant API spec
---
 core/api-merchant.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 40ee320..6feefd8 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -26,6 +26,8 @@ Merchant Backend API
 WARNING: This document describes the version 1 of the merchant backend
 API, which is NOT yet implemented at all!
 
+TODO: #5210 is not addressed by this specification!
+
 The ``*/public/*`` endpoints are publicly exposed on the Internet and accessed
 both by the user's browser and their wallet.
 
@@ -1086,6 +1088,28 @@ Giving Customer Tips
     }
 
 
+.. http:post:: /tips
+
+  Authorize creation of a tip from the given reserve, except with
+  automatic selection of a working reserve of the instance by the
+  backend. Intentionally otherwise identical to the /authorize-tip
+  endpoint given above.
+
+  **Request:**
+
+  The request body is a `TipCreateRequest` object.
+
+  **Response:**
+
+  :status 200 OK:
+    A tip has been created. The backend responds with a `TipCreateConfirmation`
+  :status 404 Not Found:
+    The instance is unknown to the backend.
+  :status 412 Precondition Failed:
+    The tip amount requested exceeds the available reserve balance for tipping
+    in all of the reserves of the instance.
+
+
 .. http:delete:: /reserves/$RESERVE_PUB
 
   Delete information about a reserve.  Fails if the reserve still has

-- 
To stop receiving notification emails like this one, please contact
address@hidden.