summaryrefslogtreecommitdiff
path: root/integration-general.rst
diff options
context:
space:
mode:
authorFlorian Dold <florian.dold@gmail.com>2016-01-12 15:47:56 +0100
committerFlorian Dold <florian.dold@gmail.com>2016-01-12 15:47:56 +0100
commitf2d880840ff04dd5b050cf9cb2ae8a8504242f30 (patch)
treed822f82965ef6748c4d4eb49d484adca17f8ae88 /integration-general.rst
parentc274498534e64226cb6face265452278ad76402c (diff)
downloaddocs-f2d880840ff04dd5b050cf9cb2ae8a8504242f30.tar.gz
docs-f2d880840ff04dd5b050cf9cb2ae8a8504242f30.tar.bz2
docs-f2d880840ff04dd5b050cf9cb2ae8a8504242f30.zip
shared presence awareness protocol
Diffstat (limited to 'integration-general.rst')
-rw-r--r--integration-general.rst18
1 files changed, 17 insertions, 1 deletions
diff --git a/integration-general.rst b/integration-general.rst
index c73e0f87..bab13c7c 100644
--- a/integration-general.rst
+++ b/integration-general.rst
@@ -11,8 +11,24 @@ on the bank website's ``HTMLDocument``.
DOM events used by Taler have the prefix ``taler-``.
-.. _communication:
+-------------------------
+Wallet Presence Awareness
+-------------------------
+
+The bank website queries the wallet's presence by sending a ``taler-probe`` event. The
+event data should be `null`.
+
+If the wallet is present and active, it will respond with a ``taler-wallet-present`` event.
+While the user agent is displaying a website, the user might deactivate or
+re-activate the wallet. A Taler-aware *should* react to those events, and
+indicate to the user that they should (re-)enable the wallet if necessary.
+
+When the wallet is activated, the ``taler-wallet-load`` event is sent
+by the wallet. When the wallet is deactivated, the ``taler-wallet-unload`` event
+is sent by the wallet.
+
+.. _communication:
----------------------
Communication Example
----------------------