[GNUnet-SVN] [taler-api] branch master updated: taler://pay draft

[gnunet]

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

dold pushed a commit to branch master
in repository api.

The following commit(s) were added to refs/heads/master by this push:
     new 19762c7  taler://pay draft
19762c7 is described below

commit 19762c76466783eaa60ff1be6f75bcdd014c4e65
Author: Florian Dold <address@hidden>
AuthorDate: Mon Aug 26 20:55:53 2019 +0200

    taler://pay draft
---
 index.rst     |  1 +
 taler-uri.rst | 36 ++++++++++++++++++++++++++++++++++++
 2 files changed, 37 insertions(+)

diff --git a/index.rst b/index.rst
index e883b58..4ed7407 100644
--- a/index.rst
+++ b/index.rst
@@ -60,6 +60,7 @@ interfaces between the core components of Taler.
   api-auditor
   api-bank
   wireformats
+  taler-uri
 
 ---------
 Licensing
diff --git a/taler-uri.rst b/taler-uri.rst
new file mode 100644
index 0000000..9165c28
--- /dev/null
+++ b/taler-uri.rst
@@ -0,0 +1,36 @@
+====================
+The taler URI scheme
+====================
+
+The `taler` URI scheme represents actions that are processed by a Taler 
wallet.  The basic syntax is as follows:
+
+.. code:: none
+
+  'taler://' action '/' params
+
+--------------------
+Requesting a Payment
+--------------------
+
+Payments are requested with the `pay` action.  The parameters are a 
hierarchical identifier for the requested payment:
+
+
+.. code:: none
+
+  'taler://pay/' merchant-host '/' merchant-query '/' merchant-instance  '/' 
order-id [ '/' session-id ]
+
+The components `merchant-host`, `merchant-query` and `order-id` identify the 
URL that is used to claim the contract
+for this payment request.
+
+To make the URI shorter (which is important for QR code payments), `-` (minus) 
can be substituted to get a default value
+for some components:
+
+* the default for `merchant-instance` is `default`
+* the default for `merchant-query` is `/public/proposal`
+
+The following is a minimal example for a payment request from the demo 
merchant, using the default instance and no session-bound payment:
+
+.. code:: none
+
+  taler://pay/backend.demo.taler.net/-/-/2019.08.26-ABCED
+

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