From c18d4b3cc3049e001d2e1e98e275b70805ab7b4a Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Fri, 10 Jun 2016 23:54:27 +0200
Subject: fix issues in documentation of the /track APIs

---
 api-exchange.rst |  2 +-
 api-merchant.rst | 34 +++++++++++++++++++++++++++++++---
 2 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/api-exchange.rst b/api-exchange.rst
index fb08ed92..16852189 100644
--- a/api-exchange.rst
+++ b/api-exchange.rst
@@ -1021,7 +1021,7 @@ typically also view the balance.)
 
     }
 
-.. http:get:: /track/transaction
+.. http:post:: /track/transaction
 
   Provide the wire transfer identifier associated with an (existing) deposit operation.
 
diff --git a/api-merchant.rst b/api-merchant.rst
index bba5c367..9992ae86 100644
--- a/api-merchant.rst
+++ b/api-merchant.rst
@@ -230,9 +230,8 @@ The following API are made available by the merchant's `backend` to the merchant
 
   :status 200 OK:
     The deposit has been executed by the exchange and we have a wire transfer identifier.
-    The response body is a `TrackTransactionResponse`_ object.  Note that
-    the similarity to the response given by the exchange for a /track/transaction
-     is completely intended.
+     The response body is a JSON array of `TransactionWireTransfer`_ objects.
+
 
   :status 202 Accepted:
     The deposit request has been accepted for processing, but was not yet
@@ -245,6 +244,35 @@ The following API are made available by the merchant's `backend` to the merchant
   :status 404 Not Found: The transaction is unknown to the backend.
 
 
+  **Details:**
+
+  .. _tsref-type-TransactionWireTransfer:
+  .. _TransactionWireTransfer:
+  .. code-block:: tsref
+
+    interface TransactionWireTransfer {
+      // 32-byte wire transfer identifier
+      wtid: Base32;
+
+      // Array of data about coins
+      coins: CoinWireTransfer[];
+    }
+
+  .. _tsref-type-CoinWireTransfer:
+  .. _CoinWireTransfer:
+  .. code-block:: tsref
+
+    interface CoinWireTransfer {
+      // public key of the coin that was deposited
+      coin_pub: EddsaPublicKey;
+
+      // Amount the coin was worth (including deposit fee)
+      amount_with_fee: Amount;
+
+      // Deposit fee retained by the exchange for the coin
+      deposit_fee: Amount;
+    }
+
 ---------
 Encodings
 ---------
-- 
cgit v1.2.3