[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] [taler-api] branch master updated: specification for #5158
From: |
gnunet |
Subject: |
[GNUnet-SVN] [taler-api] branch master updated: specification for #5158 |
Date: |
Wed, 27 Dec 2017 19:57:29 +0100 |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] [taler-api] branch master updated: specification for #5158,
gnunet <=