summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2016-03-04 11:58:07 +0100
committerChristian Grothoff <christian@grothoff.org>2016-03-04 11:58:07 +0100
commitb1dd161b7de5b40aa3a28abbc96d9675b10a138e (patch)
treebdb323c271f80897dcd5585884f284e7e1aa51a0
parentd1016d521da025f59e60a05c73621b4e4829f583 (diff)
downloaddocs-b1dd161b7de5b40aa3a28abbc96d9675b10a138e.tar.gz
docs-b1dd161b7de5b40aa3a28abbc96d9675b10a138e.tar.bz2
docs-b1dd161b7de5b40aa3a28abbc96d9675b10a138e.zip
modify /wire/test to provide bank URI and bank account numbers
-rw-r--r--api-mint.rst2
-rw-r--r--wireformats.rst20
2 files changed, 14 insertions, 8 deletions
diff --git a/api-mint.rst b/api-mint.rst
index 2b438dfa..99adfc76 100644
--- a/api-mint.rst
+++ b/api-mint.rst
@@ -226,7 +226,7 @@ Obtaining wire-transfer information
in "test" mode, this request provides a redirect to an address where
the user can initiate a fake wire transfer for testing.
- :status 302: Redirect to the webpage where fake wire transfers can be made.
+ :status 200: The mint responds with a `WireTestResponse`_ object. This request should virtually always be successful.
:status 501: This wire transfer method is not supported by this mint.
.. http:get:: /wire/sepa
diff --git a/wireformats.rst b/wireformats.rst
index be090596..8a72da0c 100644
--- a/wireformats.rst
+++ b/wireformats.rst
@@ -21,15 +21,21 @@ for a local / regional currency or accounting system. Using the TEST
wire format in combination with the Taler's bank, it is thus possible to
fully test the Taler system without using real currencies. The wire
format for "TEST" is very simple, in that it only specifies an account
-number in a field "account_number". The account number given must be
-a positive 53-bit integer. Additional fields may be present, but are
-not required.
-
-For the merchant or mint to receive deposits through TEST, the deposit
-request must thus contain a JSON object with the following fields:
+number in a field "account_number" and the URI of the bank:
* `type`: the string constant `"TEST"`
- * `account_number`: the account number of the merchant at the bank
+ * `bank_uri`: the URI of the bank
+ * `account_number`: the number of the exchange's account at the bank (for incoming transfers)
+
+The account number given must be a positive 53-bit integer.
+Additional fields may be present, but are not required.
+
+Note that a particular exchange is usually only supporting one
+particular bank with the "TEST" wire format, so it is not possible for
+a merchant with an account at a different bank to use "TEST" to
+transfer funds across banks. After all, this is for testing and not
+for real banking.
+
SEPA