blob: d69b4b0c7f0e779cdbfe3e38d35c943c5cb034f2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
====================
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
-----------
Withdrawing
-----------
.. code:: none
'taler://withdraw/' bank-host '/' bank-query '/' withdraw-uid
When `bank-query` is `-`, the default `withdraw-operation` will be used.
Example:
.. code:: none
'taler://withdraw/bank.taler.net/-/ABDE123
-------------------------
Low-level Reserve Actions
-------------------------
The following actions are deprecated. They might not be supported
in newer wallets.
.. code:: none
'taler://reserve-create/' reserve-pub
.. code:: none
'taler://reserve-confirm/' query
----------------------------
Special URLs for fulfillment
----------------------------
The special `fulfillment-success` action can be used in a fulfillment URI to indicate success
with a message, without directing the user to a website. This is useful in applications that are not Web-based:
When wallets encounter this URI in any other circumstance than going to a fulfillment URL, they must raise an error.
Example:
.. code:: none
taler://fulfillment-success/Thank+you+for+donating+to+GNUnet
|