[GNUnet-SVN] [taler-api] branch master updated: spec /refund increase out

[gnunet]

This is an automated email from the git hooks/post-receive script.

marcello pushed a commit to branch master
in repository api.

The following commit(s) were added to refs/heads/master by this push:
     new 9509d74  spec /refund increase out
9509d74 is described below

commit 9509d74dc5b0711910572ad091b281a1f128e02a
Author: Marcello Stanisci <address@hidden>
AuthorDate: Tue Jun 20 20:44:01 2017 +0200

    spec /refund increase out
---
 api-merchant.rst | 43 ++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/api-merchant.rst b/api-merchant.rst
index e8eafdf..c5ec07b 100644
--- a/api-merchant.rst
+++ b/api-merchant.rst
@@ -227,11 +227,52 @@ The following API are made available by the merchant's 
`backend` to the merchant
       proposal: Proposal;
     }
 
+.. http:post:: /refund
+
+  Increase the refund amount associated with a given order.
+
+  **Request**
+
+  The request body is a `RefundRequest`_ object.
+
+  **Response**
+
+  If the operation was successful, the backend responds with a signed 
confirmation,
+  see `RefundConfirmation`_
+
+  .. _RefundRequest:
+  .. code-block:: tsref
+
+    interface RefundRequest {
+      // Order id of the transaction to be refunded
+      order_id: string;
+
+      // Amount to be refunded
+      refund: Amount;
+
+      // Human-readable refund justification
+      reason: string;
+
+      // Merchant instance issuing the request
+      instance: string;
+    }
+
+  .. _RefundConfirmation:
+  .. code-block:: tsref
+
+    interface RefundConfirmation {
+      // Merchant signature over the hashed order id. Note
+      // that the purpose is set to zero.  However, this value
+      // is not meant to be soon verified by the frontend, but
+      // could be showed in court.
+      sig: EddsaSignature  
+    }
+  
 .. http:get:: /track/transfer
 
   Provides deposits associated with a given wire transfer.
 
-  **Request:**
+  **Request**
 
   :query wtid: raw wire transfer identifier identifying the wire transfer (a 
base32-encoded value)
   :query exchange: base URI of the exchange that made the wire transfer

-- 
To stop receiving notification emails like this one, please contact
address@hidden