[taler-docs] branch master updated: specify GET /tips/ID endpoint

[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 510d563  specify GET /tips/ID endpoint
     new 5c47aa9  Merge branch 'master' of git+ssh://git.taler.net/docs
510d563 is described below

commit 510d563bdf14457bc5dd3cc6e1288b6131b886ea
Author: Christian Grothoff <address@hidden>
AuthorDate: Thu May 21 22:40:20 2020 +0200

    specify GET /tips/ID endpoint
---
 core/api-merchant.rst | 39 +++++++++++++++++++++++++++++++--------
 1 file changed, 31 insertions(+), 8 deletions(-)

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 9aeb50a..4d728ba 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -1817,15 +1817,13 @@ Giving Customer Tips
       // Unique tip identifier for the tip that was created.
       tip_id: HashCode;
 
-      // Token that will be handed to the wallet,
-      // contains all relevant information to accept
-      // a tip.
-      tip_token: string;
-
       // URL that will directly trigger processing
       // the tip when the browser is redirected to it
       tip_redirect_url: string;
 
+      // when does the tip expire
+      tip_expiration: Timestamp;
+
     }
 
 
@@ -1932,6 +1930,34 @@ Giving Customer Tips
     }
 
 
+
+.. http:get:: /tips/$TIP_ID/pickup
+
+  Handle request from wallet to provide details about a tip.
+
+  **Response:**
+
+  :status 200 OK:
+    A tip is being returned. The backend responds with a `TipInformation`
+  :status 404 Not Found:
+    The tip identifier is unknown.
+
+  .. ts:def:: TipInformation
+
+    interface TipInformation {
+
+      // Exchange from which the tip will be withdrawn. Needed by the
+      // wallet to determine denominations, fees, etc.
+      exchange_url: string;
+
+      // Amount of the tip (including fees).
+      tip_amount: Amount;
+
+      // Timestamp indicating when the tip is set to expire (may be in the 
past).
+      // Note that tips that have expired MAY also result in a 404 response.
+      expiration: Timestamp;
+    }
+
 .. http:post:: /tips/$TIP_ID/pickup
 
   Handle request from wallet to pick up a tip.
@@ -1955,9 +1981,6 @@ Giving Customer Tips
 
     interface TipPickupRequest {
 
-      // Identifier of the tip.
-      tip_id: HashCode;
-
       // List of planches the wallet wants to use for the tip
       planchets: PlanchetDetail[];
     }

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