[GNUnet-SVN] [taler-api] branch master updated: specification for #5158

[gnunet]

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

grothoff pushed a commit to branch master
in repository api.

The following commit(s) were added to refs/heads/master by this push:
     new c1df769  specification for #5158
c1df769 is described below

commit c1df76913083db2299fbe02b3e1a459ccf6af271
Author: Christian Grothoff <address@hidden>
AuthorDate: Wed Dec 27 19:57:16 2017 +0100

    specification for #5158
---
 api-merchant.rst | 28 +++++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 5 deletions(-)

diff --git a/api-merchant.rst b/api-merchant.rst
index d57fd01..ee71bc3 100644
--- a/api-merchant.rst
+++ b/api-merchant.rst
@@ -82,11 +82,17 @@ The Frontend HTTP API
       // Public key of the merchant.  Used to identify the merchant instance.
       merchant_pub: EddsaSignature;
 
-      // the chosen exchange's base URL
-      exchange: string;
-
       // the coins used to sign the proposal
       coins: DepositedCoin[];
+
+      // Operation mode, either "pay" or "abort-refund".  "pay"
+      // is there to process the payment as usual, while
+      // "abort-refund" has the goal of aborting a previous,
+      // partial (and thus so far unsuccessful) payment request,
+      // asking for the wallet to generate refunds.  In this
+      // latter case, the response will be an array of
+      // refund signatures matching 'coins'.
+      mode: string;
     }
 
   .. _`tsref-type-DepositedCoin`:
@@ -95,7 +101,7 @@ The Frontend HTTP API
 
     interface DepositedCoin {
       // the amount this coin is paying for
-      amount: Amount;
+      constribution: Amount;
 
       // coin's public key
       coin_pub: RsaPublicKey;
@@ -103,6 +109,9 @@ The Frontend HTTP API
       // denomination key
       denom_pub: RsaPublicKey;
 
+      // base URL of the exchange that issued the coin
+      exchange_url: string;
+
       // exchange's signature over this `coin's public key <eddsa-coin-pub>`_
       ub_sig: RsaSignature;
 
@@ -206,7 +215,7 @@ The following API are made available by the merchant's 
`backend` to the merchant
   **Response:**
 
   :status 200 OK:
-    The exchange accepted all of the coins. The body is a `PaymentResponse`_.
+    The exchange accepted all of the coins. The body is a `PaymentResponse`_ 
if the request used the mode "pay", or a `PaymentRefundResponse`_ if the 
request used was the mode "abort-refund".
     The `frontend` should now fullfill the contract.
   :status 412 Precondition Failed:
     The given exchange is not acceptable for this merchant, as it is not in the
@@ -241,6 +250,15 @@ The following API are made available by the merchant's 
`backend` to the merchant
       proposal: Proposal;
     }
 
+  .. _PaymentRefundResponse:
+  .. code-block:: tsref
+
+    interface PaymentRefundResponse {
+      // array of refunds, in the order of the coins that
+      // were given originally.
+      refunds: RefundConfirmation[];
+    }
+    
 .. http:post:: /refund
 
   Increase the refund amount associated with a given order.

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