From 14b0748e6813610bd246f3dd574a0df41064cf9b Mon Sep 17 00:00:00 2001
From: Florian Dold <florian.dold@gmail.com>
Date: Tue, 8 Sep 2020 19:51:43 +0530
Subject: wallet core tipping API

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

(limited to 'taler-wallet.rst')

diff --git a/taler-wallet.rst b/taler-wallet.rst
index dd6da11f..f4dc611b 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
 -----------------
 
-- 
cgit v1.2.3