[taler-docs] branch master updated: wallet core tipping API

[gnunet]

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

dold pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 14b0748  wallet core tipping API
14b0748 is described below

commit 14b0748e6813610bd246f3dd574a0df41064cf9b
Author: Florian Dold <florian.dold@gmail.com>
AuthorDate: Tue Sep 8 19:51:43 2020 +0530

    wallet core tipping API
---
 taler-wallet.rst | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/taler-wallet.rst b/taler-wallet.rst
index dd6da11..f4dc611 100644
--- a/taler-wallet.rst
+++ b/taler-wallet.rst
@@ -843,6 +843,53 @@ Confirm Payment
       | ConfirmPayResultDone;
       | ConfirmPayResultPending;
 
+Tipping API Calls
+-----------------
+
+Preparing a tip
+~~~~~~~~~~~~~~~
+
+:Name: ``"prepareTip"``
+:Description:
+  Prepare for accepting a tip based in a taler://tip URI
+:Request:
+  .. ts:def:: PrepareTipRequest
+
+    interface PrepareTipRequest {
+      talerTipUri: string;
+    }
+:Response:
+  .. ts:def:: PrepareTipResult
+
+    interface PrepareTipResult {
+      // Unique ID for the tip assigned by the wallet.
+      // Typically different from the merchant-generated tip ID.
+      walletTipId: string;
+
+      // Has the tip already been accepted?
+      accepted: boolean;
+      tipAmountRaw: AmountString;
+      tipAmountEffective: AmountString;
+      exchangeBaseUrl: string;
+      expirationTimestamp: Timestamp;
+    }
+
+
+Accepting a tip
+~~~~~~~~~~~~~~~
+
+:Name: ``"acceptTip"``
+:Description:
+  Prepare for accepting a tip based in a taler://tip URI
+:Request:
+  .. ts:def:: AcceptTipRequest
+
+    interface AcceptTipRequest {
+      walletTipId: string;
+    }
+:Response:
+  On success, the response is an empty object.
+
 Testing API calls
 -----------------
 

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