commit cc8c7bb1867555da29fb01d1e65b08cd088c083b
parent 5a145afd5e04c8f5cd21faa828c825fd55098acd
Author: Florian Dold <florian@dold.me>
Date: Fri, 28 Jun 2024 12:39:05 +0200
spec fixes, specify withdrawal-transfer-result
Diffstat:
1 file changed, 40 insertions(+), 19 deletions(-)
diff --git a/draft-grothoff-taler.xml b/draft-grothoff-taler.xml
@@ -231,20 +231,15 @@ also <xref target="taler-registry" />).
<t>bank_host: hostname of the bank (optionally including a port number)</t>
<t>bank_prefix_path: list of path components that identifies the path prefix of the bank integration API base URL</t>
<t>withdrawal_uid: the unique ID of the withdrawal operation</t>
- </list>
-
- The following additional query parameters are supported:
- <list style="symbols">
- <t>external-confirmation (optional): when set to "1", the wallet does not show a confirmation link to the user.
+ <t>ext (optional): when set to "1", the wallet does not show a confirmation link to the user.
Useful when the withdrawal is initiated from an account that is not controlled by the same
user as the user of the wallet.</t>
</list>
-
</t>
<t>
<list style="symbols">
<t>Name: withdraw</t>
-<t>Syntax: taler://withdraw/{bank_host}{/bank_prefix_path*}/{withdrawal_uid}</t>
+<t>Syntax: taler://withdraw/{bank_host}{/bank_prefix_path*}/{withdrawal_uid}{?external-confirmation=ext}</t>
<t>Example: taler://withdraw/bank.example.com/wid</t>
<t>Contact: N/A</t>
<t>References: [this.I-D]</t>
@@ -502,6 +497,31 @@ also <xref target="taler-registry" />).
</t>
</section>
+<section anchor="registry-entry-withdrawal-transfer-result" title="Action: withdrawal-transfer-result">
+ <t>
+ A "withdrawal-transfer-result" action instructs the wallet to display the status of a withdrawal
+ to the user. Typically used to transfer control between a banking app/website and a Taler wallet.
+ Optionally, the URI can also specify an update to the status of the transfer
+ to the exchange for the withdrawal as a hint for the wallet. The wallet must only use this
+ value to show further hints to the user.
+ </t>
+<t>
+ The specific arguments of a "withdraw-exchange" action are:
+ <list style="symbols">
+ <t>ref_value: A reference for the transaction that must contain the reserve public key. Used to identify the
+ withdrawal transaction in the wallet.</t>
+ <t>status_value (optional): The status of the transfer, must be one of: "success", "aborted".</t>
+ </list>
+</t>
+<t>
+<list style="symbols">
+<t>Name: withdraw-transfer-result</t>
+<t>Syntax: taler://withdrawal-transfer-result{?ref=ref_value}{?status=status_value}</t>
+<t>Contact: N/A</t>
+<t>References: [this.I-D]</t>
+</list>
+</t>
+</section>
</section><!-- tracking -->
@@ -557,18 +577,19 @@ dots and dashes)</t>
</t>
<figure>
<artwork>
- Name | Contact | Reference
- ------------------+-------------------------+------------
- pay | N/A | [This.I-D]
- withdraw | N/A | [This.I-D]
- refund | N/A | [This.I-D]
- pay-pull | N/A | [This.I-D]
- pay-push | N/A | [This.I-D]
- pay-template | N/A | [This.I-D]
- restore | N/A | [This.I-D]
- dev-experiment | N/A | [This.I-D]
- add-exchange | N/A | [This.I-D]
- withdraw-exchange | N/A | [This.I-D]
+ Name | Contact | Reference
+ ----------------------------+-------------------------+----------
+ pay | N/A | [This.I-D]
+ withdraw | N/A | [This.I-D]
+ refund | N/A | [This.I-D]
+ pay-pull | N/A | [This.I-D]
+ pay-push | N/A | [This.I-D]
+ pay-template | N/A | [This.I-D]
+ restore | N/A | [This.I-D]
+ dev-experiment | N/A | [This.I-D]
+ add-exchange | N/A | [This.I-D]
+ withdraw-exchange | N/A | [This.I-D]
+ withdrawal-transfer-result | N/A | [This-I.D.]
</artwork>
</figure>
