update merchant spec'

1 files changed, 41 insertions, 3 deletions

diff --git a/anastasis.rst b/anastasis.rst
index fc32343b..7c10d01f 100644
--- a/anastasis.rst
+++ b/anastasis.rst
@@ -1564,24 +1564,62 @@ Expected new state:
 
 **select_challenge:**
 
+Selecting a challenge takes various formats, depending on the method.
+Specifically, in the case of a security question, the answer should
+already be provided.
+
+Arguments (example):
+
+.. code-block:: json
+
+    {
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30"
+    }
+
+.. code-block:: json
+
+    {
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30",
+        "answer": "answer to secure question"
+    }
+
+**pay:**
+
 Arguments (example):
 
 .. code-block:: json
 
     {
-        "challenge_index": 1
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30"
     }
 
 
 **solve_challenge:**
 
+Solving a challenge takes various formats, depending on the method and
+what is known about the answer.
+
 Arguments (example):
 
 .. code-block:: json
 
     {
-        "challenge_index": 1,
-        "solution": "answer to secure question"
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30",
+        "answer": "answer to secure question"
+    }
+
+.. code-block:: json
+
+    {
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30",
+        "pin": 1234
+    }
+
+.. code-block:: json
+
+    {
+        "uuid": "80H646H5ZBR453C02Y5RT55VQSJZGM5REWFXVY0SWXY1TNE8CT30",
+        "hash": "SOMEBASE32ENCODEDHASHVALUE"
     }