commit 24a772d0b6e7fca0635aca2d808e36a62a43e825 parent 01bb5c7c47acdd7c55bf99dc2e0afd1b162f177e Author: Christian Grothoff <christian@grothoff.org> Date: Mon, 13 Apr 2020 22:02:47 +0200 more work on merchant API spec Diffstat:
| M | core/api-merchant.rst | | | 24 | ++++++++++++++++++++++++ |
1 file changed, 24 insertions(+), 0 deletions(-)
diff --git 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