[taler-docs] branch master updated: work on spec for GET /private/orders/ID

[gnunet]

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

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 1d396d0  work on spec for GET /private/orders/ID
1d396d0 is described below

commit 1d396d031a03e12501bb9b06b642366c7fbe4313
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Sun Jun 7 21:58:00 2020 +0200

    work on spec for GET /private/orders/ID
---
 core/api-merchant.rst | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 03aefed..2110a89 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -1079,19 +1079,32 @@ Receiving Payments
   .. ts:def:: CheckPaymentPaidResponse
 
     interface CheckPaymentPaidResponse {
+      // did the customer pay for this contract
       paid: true;
 
       // Was the payment refunded (even partially)
       refunded: boolean;
 
-      // Amount that was refunded, only present if refunded is true.
+      // Total amount the exchange deposited into our bank account
+      // for this contract, excluding fees.
+      deposits_total: Amount;
+
+      // Total value of the coins the exchange deposited into our bank account
+      // for this contract, includes the fees (which the exchange charged).
+      transfer_value_total: Amount;
+
+      // Total amount that was refunded, only present if refunded is true.
       refund_amount?: Amount;
 
       // Contract terms
       contract_terms: ContractTerms;
 
       // If available, the wire transfer status from the exchange for this 
order
-      wire_details?: TransactionWireTransfer;
+      wire_details?: TransactionWireTransfer[];
+
+      // If available, the refund details for this order.  One entry per
+      // refunded coin.
+      refund_details?: RefundDetails[];
     }
 
   .. ts:def:: CheckPaymentUnpaidResponse
@@ -1110,6 +1123,20 @@ Receiving Payments
       // exist in case the wallet did not yet claim them.
     }
 
+  .. ts:def:: RefundDetails
+
+    interface RefundDetails {
+
+      // Reason given for the refund
+      reason: string;
+
+      // when was the refund approved
+      timestamp: Timestamp;
+
+      // Total amount that was refunded (minus a refund fee).
+      amount: Amount;
+    }
+
   .. ts:def:: TransactionWireTransfer
 
     interface TransactionWireTransfer {

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.