taler-docs

commit f044a99f79e2937176f10a94de20de1d111851e4
parent 290dec84dc1a07356c69e7c76e9a306882215edb
Author: ms <ms@taler.net>
Date:   Mon,  8 Nov 2021 13:36:17 +0100

Access API.

Diffstat:
M
core/api-bank-access.rst
 | 
22
+++++++++++-----------

1 file changed, 11 insertions(+), 11 deletions(-)
diff --git a/core/api-bank-access.rst b/core/api-bank-access.rst
@@ -129,6 +129,7 @@ name and account password, at least in the GNU Taler demo bank implementation.
 .. http:POST:: ${BANK_API_BASE_URL}/accounts/${account_name}/withdrawals/${withdrawal_id}/confirm
 
   Confirm a withdrawal operation.  Has no effect on an already confirmed withdrawal operation.
+  This call is responsible of wiring the funds to the exchange.
 
   **Response**
 
@@ -145,8 +146,9 @@ Transactions
 
 .. http:GET:: ${BANK_API_BASE_URL}/accounts/${account_name}/transactions
 
-   Retrieve all the transactions where the bank account with the label ``account_name``
-   was debited or credited.
+   Retrieve all the fresh transactions where the bank account with the
+   label ``account_name`` was debited or credited.  A transactions is 'fresh'
+   if it was never included in a "history" type response.
 
    **Request**
   
@@ -154,6 +156,8 @@ Transactions
 
    **Response**
    
+   .. ts:def:: BankAccountTransactionsResponse
+
      interface BankAccountTransactionsResponse {
        transactions: BankAccountTransactionInfo[]; 
      }
@@ -197,16 +201,12 @@ Transactions
    
       interface CreateBankAccountTransactionCreate {
 
-        // All the details corresponding to the wire transfer
-        // to initiate, in the 'payto' format (RFC 8905).
-        // Only: 'iban' authority and 'receiver-name', 'amount',
-        // and 'message' query parameters are accepted.
- 
-        // The following example is accepted:
-        //
-        // payto://iban/AB0123456789?receiver-name=Jane%20Doe&message=donation&amount=EUR:1
- 
+        // Support 'iban' and 'x-taler-bank' authorities.  'iban'
+        // target type should specify a BIC too.
         paytoUri: string;
+
+        amount: string; // with currency
+        subject: string;
       }
 
    **Response**